goal-plan

Creates and executes Goal-Oriented Action Plans with precondition analysis and adaptive replanning.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill goal-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goal-plan
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-goals/skills/goal-plan
Command: npx skills add https://github.com/ruvnet/claude-flow --skill goal-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complex objectives with multiple dependent steps often fail because plans are static and break when conditions change. This Skill structures goal execution using Goal-Oriented Action Planning (GOAP), tracking preconditions, effects, and costs so plans can adapt when reality diverges from expectations.

Core Features & Use Cases

  • GOAP Plan Generation: Defines goal state, assesses current state, inventories actions with preconditions/effects/costs, and finds an optimal action sequence using A* search through the state space.
  • Trajectory Tracking: Records each execution step via ruflo intelligence hooks so plan progress is observable and auditable.
  • Adaptive Replanning: Detects failures, unexpected side effects, or changed goals, then recalculates the optimal path from the new state and updates remaining tasks.
  • Use Case: You need to migrate a service to a new database with zero-downtime constraints. The Skill maps each migration step's preconditions and effects, creates tracked tasks, and replans automatically if a step fails mid-migration.

Quick Start

Ask the agent to create a goal plan for migrating your staging database to PostgreSQL with verification at each step.

Frequently Asked Questions about goal-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a goal-oriented action plan for a complex task?

Define the goal state with concrete success criteria, assess the current state, then inventory available actions with their preconditions, effects, and costs. The Skill generates an optimal action sequence using A* search through the state space and creates tracked tasks for each step.

What is GOAP and when should I use it for planning?

GOAP (Goal-Oriented Action Planning) is a planning technique where actions are selected based on preconditions and effects rather than fixed sequences. Use it when objectives have multiple dependent steps, changing conditions, or a need for adaptive replanning during execution.

How does adaptive replanning work when a step fails?

When an action fails or produces unexpected results, the Skill reassesses the current state, recalculates the optimal path from the new state, and updates remaining tasks. Replanning triggers include failed preconditions, side effects, changed goals, exceeded cost thresholds, and unavailable dependencies.

Does goal-plan require specific tools or MCP servers?

Yes, it requires the ruflo-core MCP plugin tools for task creation, memory storage, workflow execution, and trajectory tracking hooks. It also uses standard Bash, Read, Write, and Edit tools for executing plan actions.

When should I not use GOAP-style planning?

Avoid GOAP for simple linear tasks with no branching dependencies, where a fixed checklist is sufficient. The overhead of state assessment, cost estimation, and trajectory tracking only pays off when plans may need to change mid-execution.