# Architecture Decision Records ADRs capture cross-cutting or hard-to-reverse decisions. Add a new ADR when changing providers, async strategy, data model boundaries, or other architectural choices. Use the template in `docs/templates/adr.md` and increment the numeric prefix (`0002`, `0003`, ...).