goal-plan
Create and execute Goal-Oriented Action Plans (GOAP) with precondition analysis, cost optimization, and adaptive replanning
- Installs
- 770
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/ruvnet/ruflo --skill goal-plan- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads goal-plan automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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
- Define goal state — what does "done" look like? List concrete success criteria
- Assess current state — what's true now? What assets, code, infrastructure exist?
- Identify gap — what must change between current and goal state?
- 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)
- Generate plan — find the optimal action sequence using A* through the state space
- Record trajectory — call
mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-startto begin tracking - Create tasks — call
mcp__plugin_ruflo-core_ruflo__task_createfor each action in the plan - 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__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step
- Monitor & replan — if an action fails or produces unexpected results:
- Reassess current state
- Recalculate optimal path from new state
- Update remaining tasks
- Complete trajectory — call
mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-end - Store successful plan — call
mcp__plugin_ruflo-core_ruflo__memory_storewith namespacegoap-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
FAQ
What does the goal-plan skill do?
Create and execute Goal-Oriented Action Plans (GOAP) with precondition analysis, cost optimization, and adaptive replanning
How do I install goal-plan?
Run npx skills add https://github.com/ruvnet/ruflo --skill goal-plan in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/goal-plan/ (personal) or .claude/skills/goal-plan/ (project).
Which AI agents can use goal-plan?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is goal-plan safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains goal-plan?
It is published by ruvnet in ruvnet/ruflo. It has 770 recorded installs.
More from ruvnet/ruflo
swarm-orchestration
ruvnet/ruflo
Multi-agent swarm coordination for complex tasks. Uses hierarchical topology with specialized agents to break down and execute complex work across multiple files and modules. Use when: 3+ files need changes, new feature implementation, cross-module refactoring, API changes with tests, security-related changes, performance optimization across codebase, database schema changes. Skip when: single file edits, simple bug fixes (1-2 lines), documentation updates, configuration changes, quick exploration.
agent-arch-system-design
ruvnet/ruflo
Agent skill for arch-system-design - invoke with $agent-arch-system-design
agent-workflow
ruvnet/ruflo
Agent skill for workflow - invoke with $agent-workflow
security-audit
ruvnet/ruflo
Comprehensive security scanning and vulnerability detection. Includes input validation, path traversal prevention, CVE detection, and secure coding pattern enforcement. Use when: authentication implementation, authorization logic, payment processing, user data handling, API endpoint creation, file upload handling, database queries, external API integration. Skip when: read-only operations on public data, internal development tooling, static documentation, styling changes.
github-project-management
ruvnet/ruflo
Comprehensive GitHub project management with swarm-coordinated issue tracking, project board automation, and sprint planning
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.