Goal Plan

What it does

Example prompts

• “/goal-plan”

Requirements

• Pre-approved tools (allowed-tools): mcp__plugin_ruflo-core_ruflo__task_create, mcp__plugin_ruflo-core_ruflo__task_list, mcp__plugin_ruflo-core_ruflo__task_status, mcp__plugin_ruflo-core_ruflo__task_assign, mcp__plugin_ruflo-core_ruflo__task_update, mcp__plugin_ruflo-core_ruflo__task_complete, mcp__plugin_ruflo-core_ruflo__task_summary, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__neural_predict, mcp__plugin_ruflo-core_ruflo__workflow_create, mcp__plugin_ruflo-core_ruflo__workflow_execute, mcp__plugin_ruflo-core_ruflo__workflow_status, mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-start, mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step, mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-end, Bash, Read, Write, Edit

Workflow steps

11 steps, taken from the first numbered list in SKILL.md.

1. 1Define goal state — what does "done" look like? List concrete success criteria
2. 2Assess current state — what's true now? What assets, code, infrastructure exist?
3. 3Identify gap — what must change between current and goal state?
4. 4Inventory actions — list available actions with
5. 5Generate plan — find the optimal action sequence using A* through the state space
6. 6Record trajectory — call mcpplugin_ruflo-core_ruflohooks_intelligence_trajectory-start to begin tracking
7. 7Create tasks — call mcpplugin_ruflo-core_ruflotask_create for each action in the plan
8. 8Execute — work through tasks in dependency order
9. 9Monitor & replan — if an action fails or produces unexpected results
10. 10Complete trajectory — call mcpplugin_ruflo-core_ruflohooks_intelligence_trajectory-end
11. 11Store successful plan — call mcpplugin_ruflo-core_ruflomemory_store with namespace goap-plans

What it can do on your machine

Read from SKILL.md and the folder at commit 6c04654. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • mcp__plugin_ruflo-core_ruflo__task_create
  • mcp__plugin_ruflo-core_ruflo__task_list
  • mcp__plugin_ruflo-core_ruflo__task_status
  • mcp__plugin_ruflo-core_ruflo__task_assign
  • mcp__plugin_ruflo-core_ruflo__task_update
  • mcp__plugin_ruflo-core_ruflo__task_complete
  • mcp__plugin_ruflo-core_ruflo__task_summary
  • mcp__plugin_ruflo-core_ruflo__memory_store
  • mcp__plugin_ruflo-core_ruflo__memory_search
  • mcp__plugin_ruflo-core_ruflo__neural_predict

  …and 10 more on the same allowed-tools line.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Goal Plan loads about 807 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 224 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~33

When it runs · the whole SKILL.md, loaded when a task matches

~807

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: mcp__plugin_ruflo-core_ruflo__task_create, mcp__plugin_ruflo-core_ruflo__task_list, mcp__plugin_rufl

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/ruflo at commit 6c04654, republished under its MIT licence (© ruvnet). 224 words, ~807 tokens.

name

goal-plan

description

Create and execute Goal-Oriented Action Plans (GOAP) with precondition analysis, cost optimization, and adaptive replanning

allowed-tools

mcp__plugin_ruflo-core_ruflo__task_create, mcp__plugin_ruflo-core_ruflo__task_list, mcp__plugin_ruflo-core_ruflo__task_status, mcp__plugin_ruflo-core_ruflo__task_assign, mcp__plugin_ruflo-core_ruflo__task_update, mcp__plugin_ruflo-core_ruflo__task_complete, mcp__plugin_ruflo-core_ruflo__task_summary, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__neural_predict, mcp__plugin_ruflo-core_ruflo__workflow_create, mcp__plugin_ruflo-core_ruflo__workflow_execute, mcp__plugin_ruflo-core_ruflo__workflow_status, mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-start, mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step, mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-end, Bash, Read, Write, Edit

argument-hint

<goal-description>

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]

© ruvnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/ruflo-goals/skills/goal-plan of ruvnet/ruflo.

Open the folder on GitHubat commit 6c04654