| name | architecture-writer |
| description | Generate or update docs/architecture.md with responsibility split, data ownership, data flow diagrams, API contract strategy, integration modes, and explicit non-goals. Load for "write architecture doc", "document system design", "create architecture diagram", "map data flow", or "define API contracts". Skip for minor code changes that don't affect architecture. |
Architecture Writer
Produce or update docs/architecture.md from the real codebase — not generic templates.
| Content | Path |
|---|
| Phases 1–6 detail | references/phases.md |
| Stop / deliverable / anti-patterns | references/stop-deliverable-antipatterns.md |
Phase map
- Discover existing architecture docs + code layout.
- Responsibility split (who owns what).
- Data ownership (tables/collections → services).
- Data flow (ASCII diagram).
- API contract strategy + sync.
- Non-goals (explicit out-of-scope).
Hard rules
- Prefer evidence from code over aspirational design.
- Mark unknowns; do not invent services.
- Ask before overwriting a substantially different existing doc.
- Link domain terms to
GLOSSARY.md when present.