writing-plans
Installation
SKILL.md
Core Principles
Plans are execution contracts, not wish lists.
- Progressive disclosure: Plan index first, then goal, then knockouts, then methodology.
- Goal.md is the contract: It defines scope, boundaries, mandatory steps, and completion criteria.
- Knockouts (KOs) are the work: Each KO is an independent slice that can be executed, validated, and merged.
- Deviation tracking is mandatory: Blockers go in DEVIATIONS.md, not in memory.
Workflow
- Determine plan type — Reorganization, theming, feature, or audit. See
references/plan-types.md. - Create directory —
docs/plans/P{NN}-<name>/. Seereferences/registry-structure.mdfor the root README. - Write goal.md — The execution contract. See
references/goal-structure.md. - Write methodology.md — The 7-step protocol. See
references/methodology-structure.md. - Write knockout files — One per independent task. See
references/ko-structure.md. - Write index.md — The plan index with progress tracker. See
references/index-structure.md. - Audit before executing — See
references/audit-checklist.md.