Guide

Project Planning

Use `plan` when you want an execution-ready plan before code changes.

The plan workflow is for tasks where the user wants the shape of the work decided before implementation begins.

A good plan is grounded in the real repository, ordered by dependency, and explicit about risks and validation.

Planning Process

  • Inspect the current code or repository layout first.
  • Define target behavior, explicit non-goals, dependencies, and constraints.
  • Break the work into sequenced implementation steps.
  • Capture API, data, migration, and config changes.
  • Define validation and acceptance criteria.