Simple Plan

Plan a small change in one focused conversation. Produce a concise proposal.md, one spec per capability, an optional design.md, and a tasks.md handoff. The artifacts must be self-contained for an implementing agent with no conversation history.

Process

1. Understand the problem, desired behavior, success criteria, and scope. Lightly inspect related specifications and relevant code so questions and artifacts reflect the existing system.
2. Use codagent:ask-questions to resolve only material behavior, boundaries, errors, edge cases, and scope. Recommend defaults and decide ordinary implementation details from context.
3. Decide whether design.md is necessary. Default to no; write one only for a consequential architectural choice, non-obvious rationale, migration, integration strategy, or implementation constraint that the implementer otherwise would not know.
4. Present the proposed capability set, design-doc decision, output location, and consequential assumptions for user approval.
5. Write all artifacts in one pass, then check them together for missing decisions or contradictions.