20 · ADRs, contracts, runbooks
Architecture governance
Every decision recorded, every tool specified, before it is built.
Decisions, tool contracts, state machines and an operations runbook that needs no AI live in the repos beside the code, each with its status and the commit it was checked against.
- 01Decisions as ADRs — each with status, date, scope, decision and consequences.
- 02A contract per tool — each stamped with the commit it was verified against.
- 03State machines before code — every entity's states drawn and linted, with a conformance verdict.
- 04A runbook that needs no AI — eighteen sections of exact commands, each with its verification.
- 05Tickets in the repo — follow-ups filed beside the code they change.
Internal
- 24 ADRs
- 22 tool contracts
- 18 runbook sections
SurfacesDocs
- Markdown
- Mermaid
- ADRs
- State-machine linter
- GitLab