ExecPlan
An ExecPlan is a durable, self-contained execution document for one complex implementation. It complements the transient task plan; it does not replace the product plan or session-orchestrate program tracking.
Create
- Read the repo's product/architecture owner and existing plan convention before choosing a path.
- Reuse the declared ExecPlan directory. If none exists, use
docs/exec-plans/active/. - Research only the files, dependencies, tests, and constraints needed to make the plan executable.
- Write a plan containing:
- user-visible purpose and observable success;
- current-state orientation and exact owner paths;
- scoped non-goals and authorization boundaries;
- ordered milestones with commands and expected evidence;
- progress checklist, decision log, surprises, and outcomes;
- idempotency and recovery notes for risky steps.
- Keep product roadmap status in its existing owner. Link to it rather than copying it.
Maintain
- Update progress and decisions as implementation proceeds.
- Record discovered constraints where they change execution.
- Move a completed plan to the repo's completed-plan location only after its observable success criteria are verified.
- Do not mark incomplete milestones complete to make the document look current.
Boundary
execplan: one complex implementation document.session-orchestrate: chooses and advances session-sized goals across the product plan.- product/implementation owner docs: define roadmap scope and status.
- transient task plan: coordinates the current agent turn.