SKILL.md
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.