This section records architecture decision records (ADRs). Each ADR explains why a significant decision was made and what alternatives were considered.
Write an ADR when the decision:
- Is hard to reverse.
- Affects multiple layers or teams.
- Has non-obvious trade-offs.
adr-template.md— template for new ADRs.
Use a sequential number and a short kebab-case title:
decisions/
001-use-uuid-for-ids.md
002-choose-postgresql.md