implementation-planning
GitHub将需求转化为可执行计划,驱动分步执行并经过审查检查点。适用于多步骤任务、交接工作或防止实施过程失控,确保每步验证后再继续。
Trigger Scenarios
Install
npx skills add cbrock84/headcount --skill implementation-planning -g -y
SKILL.md
Frontmatter
{
"name": "implementation-planning",
"description": "Turns a spec or requirement into a written plan a separate session or agent can execute, then drives that plan through review checkpoints. Use this before touching code on any multi-step task, when work needs handing to someone else, when a task keeps sprawling mid-implementation, or when a plan exists and needs executing in order with verification between steps."
}
Implementation planning
When a plan is worth writing
More than about three steps, more than one file of consequence, or any work that will be handed off. Below that, planning costs more than it saves.
Writing the plan
A plan is executable when someone who was not in the conversation can follow it without guessing. That means every step names:
- The change — the file or surface, and what it should do afterward.
- The proof — the command that shows it worked. "Run the tests" is not a step; the exact invocation is.
- The checkpoint — whether a human reviews before the next step starts.
Order steps so the system is working at the end of each one. A plan whose midpoint is a broken build cannot be paused, and every plan gets paused.
State up front what is out of scope. Plans fail by accretion far more often than by being wrong.
Executing
- One step at a time, in order. Finish and verify before starting the next.
- Stop at checkpoints. The point of a checkpoint is that continuing without it is a mistake.
- When reality contradicts the plan, stop and amend the plan. Do not improvise past it silently — the plan is the shared state, and a stale plan is worse than none.
- Track status in the plan as you go, so an interrupted run can resume.
Never
- Start writing code because the plan felt obvious. If it was obvious, writing it costs a minute.
- Mark a step done without running its proof.
- Expand scope mid-execution. Note it, finish the plan, then decide.
Version History
- d58a7ee Current 2026-09-02 21:11


