Read in order:
AGENTS.mdARCHITECTURE.mddocs/PLANS.mddocs/EXECUTION_GUIDE.md- relevant
docs/product-specs/* - relevant
docs/ideas/backlog/*brief if the work is being promoted from ideation - nearest nested
AGENTS.mdif any
For complex, ambiguous, or risky work, prefer this flow:
- start with native Codex
/planmode - if the work is feature-shaped or trust-sensitive, use
expert-roundtable - use
execplan-decompose - draft or update one ExecPlan in
docs/exec-plans/active/ - if an ExecPlan already exists, update it instead of creating a duplicate
- before implementation, use
feature-criticand fold material findings back into the plan
Output:
- create or update one file under
docs/exec-plans/active/
Requirements:
- include all required sections from
docs/PLANS.md - include exact file paths
- include exact verification commands
- include explicit assumptions
- carry forward the rationale, priority, and promotion trigger from an existing
docs/ideas/backlog/*brief when one exists - include rollout/rollback or recovery guidance when relevant
- include screencast steps for any new feature or material user-visible workflow change
- update
Progress,Surprises & Discoveries, andDecision Logas work proceeds
Do not:
- ask the user for “next steps” when the plan already implies them
- leave the plan without current progress after meaningful work
- create planning theater; optimize for an executable artifact