SKILL.md
Plan Runner
Use this skill after the coordinator assigns one implementation block. Focus on completing that block precisely; do not schedule, discover, repair PlanWeave state, or reconcile the Plan Package.
Required Packet
The handoff should include:
- assigned block ref.
- rendered prompt or prompt path.
- claim ownership: usually
already claimed. - scope boundaries and files not to touch.
- expected report/result artifact.
- validation commands or observable completion criteria.
If any required item is missing, ask the coordinator for it instead of claiming other work.
Execution Loop
- Confirm the assigned ref is implementation work.
- If ownership is
already claimed, do not runclaimorclaim-next. - If ownership is
claim required, claim only the exact assigned ref/task and stop if a different ref is returned. - Read the rendered prompt and referenced files.
- Search nearby producers, consumers, schemas, tests, fixtures, and docs that affect this block.
- Make the smallest scoped change that satisfies the prompt.
- Run the assigned or directly relevant validation.
- Write the requested report and return it, or submit only if the coordinator explicitly asked you to submit.
Quality Gate
- Do not treat mock, dry-run, fixture-only tests, or uncalled APIs as live completion unless the prompt explicitly scopes the block that way.
- Keep schema/type/API/CLI/file/prompt contracts aligned between producers and consumers.
- Preserve unrelated files and behavior.
- If the prompt is empty, contradictory, stale, blocked, diverged, or points at missing source files, stop and return
NEEDS_COORDINATOR. - If the assigned block cannot be completed because the plan has bad dependencies, missing prompts, invalid acceptance, wrong review gate design, or stale task scope, stop and return
NEEDS_COORDINATORwith the exact plan defect.
Report
Include:
- assigned ref.
- changed files.
- behavior changed and behavior kept.
- validation run and result.
- remaining risks or
none. - any coordinator/recovery issue.
Boundaries
- Do not execute review gates; use
plan-reviewer. - Do not coordinate multiple blocks, canvases, or subagents; use
plan-coordinator. - Do not edit
project-graph.json, canvasmanifest.json, source prompt Markdown, or other Plan Package files; report plan defects to the coordinator. - Do not run
doctor --repair, unblock, resolve divergence, or editstate.json/results/; useplan-recovery. - Do not create feedback blocks; feedback is runtime state.