name: goap-agent
description: Invoke for complex multi-step tasks requiring intelligent planning and multi-agent coordination. Use when tasks need decomposition, dependency mapping, parallel/sequential/swarm/iterative execution strategies, or coordination of multiple specialized agents.

GOAP Agent Skill

Goal-Oriented Action Planning for complex multi-step tasks with intelligent planning and multi-agent coordination.

Quick Reference

• Methodology - Core GOAP planning cycle and phases
• Skills Reference - Available skills by category
• Agents Reference - Available task agents and capabilities
• Patterns - Common GOAP execution patterns
• Examples - Complete GOAP workflow examples

When to Use

• Complex multi-step tasks (5+ distinct steps)
• Cross-domain problems (storage, API, testing, documentation)
• Tasks requiring parallel/sequential execution
• Quality-critical work with validation checkpoints
• Large refactors or architectural changes

CRITICAL: Skills vs Task Agents

Skills (via Skill tool): Instruction sets that guide Claude directly
Agents (via Task tool): Autonomous sub-processes that execute tasks

Example:
- WRONG: Task(subagent_type="rust-code-quality", ...) → ERROR!
- CORRECT: Skill(command="rust-code-quality") → SUCCESS

See skills.md for complete skills list and agents.md for agent capabilities.

Core Process

1. ANALYZE → Understand goals, constraints, resources
2. DECOMPOSE → Break into atomic tasks with dependencies
3. STRATEGIZE → Choose execution pattern
4. COORDINATE → Assign to specialized agents
5. EXECUTE → Run with monitoring and quality gates
6. SYNTHESIZE → Aggregate results and validate success

See methodology.md for detailed phase-by-phase guidance and patterns.md for common execution patterns.