Architecture Decision Records

ADRs capture significant architectural decisions: what we decided, what we considered, what we chose, and what we accepted as the consequences. Each one is dated and numbered so the history stays legible as the codebase evolves.

Add a new ADR (NNNN-slug.mdx) when a decision is non-obvious, has alternatives worth recording, or commits us to a direction that’s costly to reverse. Don’t rewrite accepted ADRs — supersede them with a new entry that links back.

(no ADRs yet)