goap-agent

Original：🇺🇸 English

Translated

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.

2installs

Sourced-o-hub/rust-self-learning-memory

Added on2026-02-21

NPX Install

npx skill4agent add d-o-hub/rust-self-learning-memory goap-agent

SKILL.md Content

View Translation Comparison →

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
Execution Strategies - Parallel, Sequential, Swarm, Hybrid patterns
Skills Reference - Available skills by category
Agents Reference - Available task agents and capabilities
Patterns - Common GOAP execution patterns
Examples - Complete GOAP workflow examples
ADR-022 - Architecture Decision Record

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

ANALYZE → Understand goals, constraints, resources
- Check ADRs: Read relevant ADRs from
```
plans/adr/
```
  before planning
DECOMPOSE → Break into atomic tasks with dependencies
STRATEGIZE → Choose execution pattern
COORDINATE → Assign to specialized agents
EXECUTE → Run with monitoring and quality gates
SYNTHESIZE → Aggregate results and validate success

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

ADR Integration Workflow

MANDATORY: Always check ADRs in

plans/adr/

before creating execution plans:

Step 1: ADR Discovery

bash

# List all ADRs to identify relevant ones
ls plans/adr/ADR-*.md

Step 2: Read Relevant ADRs

Search for ADRs related to your task domain
Note architectural decisions and constraints
Check ADR status (Accepted/Implemented vs Deprecated)

Step 3: Incorporate into Planning

Use ADR constraints when decomposing tasks
Reference ADRs in execution plans
Ensure compliance with architectural decisions

Step 4: Update Progress in plans/

Create/update execution plan files in
```
plans/
```
Document progress, blockers, and decisions
Link to relevant ADRs in plan files