Architecture Decision Records¶

These records capture the non-obvious architectural and product decisions taken during the project. The goal is not to document every choice — small choices live in commit messages — but to record the ones where the rationale would be easy to forget and expensive to re-derive.

Index¶

Format¶

Each ADR follows a compressed MADR template:

Status — proposed, accepted, deprecated, superseded.
Context — what forced the decision.
Decision — what we chose, in one paragraph.
Consequences — positive and negative effects, including the ones we knowingly accept.

ADRs are immutable. To change a decision, write a new ADR that supersedes the old one and update the Status of the original.