Architecture Doc Design

Convert architecture discussions into concise docs that another engineer or AI agent can implement from.

Core Workflow

1. Capture decisions, not transcript.
2. Separate confirmed constraints from derived design.
3. Keep docs short enough to maintain.
4. Prefer fewer docs with clear ownership over many narrow docs.
5. End with implementation-prompt.md when the design is stable enough to build.

Reference Routing

Read references/design-doc-rules.md when creating or revising architecture docs, especially when you need: