Architecture Decisions
Architecture decision records preserve decisions that are expensive to reverse, affect multiple modules, or establish public contracts. They explain why a design was selected while the current architecture pages describe how the system works now.
Accepted decisions
Rules
- Use the next four-digit number and a lowercase kebab-case title.
- Accepted records are not rewritten to hide historical trade-offs.
- A changed decision receives a new ADR that explicitly supersedes the previous one.
- Update current architecture and module documentation when a decision changes implementation.