Skip to main content
Use a coding plan when the proposed implementation needs review before the agent changes code. Keep it specific enough to expose risks and omissions, but do not turn it into a transcript or prewrite every line.

Annotated example

The example names the outcome, boundary, precise change, and proof. It does not prescribe unrelated refactors. For a larger generated example, inspect the 69-task Spec Kit list for reliable webhook delivery. It is the task artifact from a complete Spec Kit planning flow.

Review prompts

  • Does the plan solve the stated problem rather than only the visible symptom?
  • Are affected data, API, security, compatibility, and user-interface boundaries named?
  • Can each validation step fail for the bug the plan claims to prevent?
  • What maintained documentation must describe the result after implementation?
This template is Plannotator-authored. Its structure is informed by primary sources including Superpowers’ writing-plans skill, GSD Core’s planning-artifacts reference, and GitHub Spec Kit’s plan template. It does not copy those templates. Use open-source plan review to annotate it locally or Workspaces when several people or agents need the same shared document. Reviewed July 19, 2026. Written and maintained by the Plannotator documentation team.
Last modified on July 20, 2026