Goal Plan

Create and execute intelligent plans using Goal-Oriented Action Planning (GOAP).

When to use

When you have a complex objective that requires multiple steps, has dependencies between steps, and may need adaptive replanning as conditions change.

Steps

1. Define goal state — what does "done" look like? List concrete success criteria
2. Assess current state — what's true now? What assets, code, infrastructure exist?
3. Identify gap — what must change between current and goal state?
4. Inventory actions — list available actions with:

• Preconditions (what must be true before this action)
• Effects (what becomes true after this action)
• Cost estimate (time, complexity, risk)

1. Generate plan — find the optimal action sequence using A* through the state space
2. Record trajectory — call mcp__claude-flow__hooks_intelligence_trajectory-start to begin tracking
3. Create tasks — call mcp__claude-flow__task_create for each action in the plan
4. Execute — work through tasks in dependency order:

• Before each action: verify preconditions still hold
• After each action: verify effects achieved
• Record each step via mcp__claude-flow__hooks_intelligence_trajectory-step

1. Monitor & replan — if an action fails or produces unexpected results:

• Reassess current state
• Recalculate optimal path from new state
• Update remaining tasks

1. Complete trajectory — call mcp__claude-flow__hooks_intelligence_trajectory-end
2. Store successful plan — call mcp__claude-flow__memory_store with namespace goap-plans

Plan output format

Goal: [concrete objective]
Current State: [key facts]
Plan Cost: [estimated effort]
Steps:
  1. [action] — precondition: [X], effect: [Y], cost: [Z]
  2. [action] — precondition: [Y], effect: [W], cost: [Z]
  ...
Risk Factors: [what could force a replan]
Fallback: [alternative approach if primary path fails]

Replanning triggers

• Action fails (precondition no longer met)
• Unexpected side effects detected
• New information changes goal definition
• Cost exceeds threshold
• External dependency becomes unavailable