# Architecture Decision Records (ADR)

## Why ADRs

- Track architectural decisions.
- Preserve context and rejected alternatives.
- Improve onboarding and future reviews.

## Naming convention

- `NNNN-short-title.md`
- Example: `0001-http-client-choice.md`

## Process

- Create an ADR for any long-term architectural decision.
- Link the ADR in the corresponding PR.
