ExecPlan

An ExecPlan is a self-contained, living design document that guides a stateless agent (or novice human) through a complex implementation end-to-end. It replaces vague task descriptions with concrete, verifiable steps. The bar: a fresh agent with zero prior context reads the plan top-to-bottom and produces a working, observable result.

When to use

Use an ExecPlan when work spans multiple files, requires research, has significant unknowns, or would take more than a focused session to complete. For small, well-understood changes, skip the plan and just do the work.

File organization

One plan per file. Store all plans in a plans/ directory at the repo root. Name files descriptively: plans/add-webhook-support.md, plans/migrate-to-v2-api.md.