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

  1. Determine plan type — Reorganization, theming, feature, or audit. See references/plan-types.md.
  2. Create directorydocs/plans/P{NN}-<name>/. See references/registry-structure.md for the root README.
  3. Write goal.md — The execution contract. See references/goal-structure.md.
  4. Write methodology.md — The 7-step protocol. See references/methodology-structure.md.
  5. Write knockout files — One per independent task. See references/ko-structure.md.
  6. Write index.md — The plan index with progress tracker. See references/index-structure.md.
  7. Audit before executing — See references/audit-checklist.md.
Installs
9
First Seen
Jun 1, 2026
writing-plans — redpanda77/skills