gaoscode/planweave

plan-runner

Execute one assigned PlanWeave implementation block with scoped code changes, validation, and a completion report. Use when a coordinator assigns a specific implementation ref, prompt, scope, and reporting expectation.

First seen Jun 14, 2026

Installation

$ npx skills add gaoscode/planweave --skill plan-runner

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from gaoscode/planweave.

npx skills add gaoscode/planweave

Browse all from gaoscode/planweave

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 373
License LICENSE
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,815 B
  • docs SUMMARY.md 237 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 46 installs

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

  1. Confirm the assigned ref is implementation work.
  2. If ownership is already claimed, do not run claim or claim-next.
  3. If ownership is claim required, claim only the exact assigned ref/task and stop if a different ref is returned.
  4. Read the rendered prompt and referenced files.
  5. Search nearby producers, consumers, schemas, tests, fixtures, and docs that affect this block.
  6. Make the smallest scoped change that satisfies the prompt.
  7. Run the assigned or directly relevant validation.
  8. 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_COORDINATOR with 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, canvas manifest.json, source prompt Markdown, or other Plan Package files; report plan defects to the coordinator.
  • Do not run doctor --repair, unblock, resolve divergence, or edit state.json / results/; use plan-recovery.
  • Do not create feedback blocks; feedback is runtime state.