Table of Contents
Architecture Decision Records (ADRs)¶
Lightweight records of significant decisions. New ones are immutable once Accepted — supersede rather than edit. Copy 0000-template.md to start one.
Index¶
| # | Title | Status | Date |
|---|---|---|---|
| 0001 | Record architecture decisions | Accepted | 2026-06-26 |
| 0002 | … | — | — |
When to write one¶
- Choosing a framework/library that's hard to reverse (router, ORM, DI tool).
- Defining a layering/architecture boundary (hexagonal ports, module split).
- A protocol or data-model decision (REST vs gRPC, schema design).
- Any choice you'd want to justify in an interview.