# Architecture Decision Records

Architecture Decision Records (ADRs) capture significant technical decisions along with their context, alternatives considered, and consequences. They serve as a historical record so that future contributors understand _why_ a particular approach was chosen.

For a summary table of all ADRs, see the [ADR Index](/ai-gateway/developer-guide/adr-index/).

## Creating a New ADR

ADR files follow the pattern `adr/NNN-short-descriptive-title.md` at the repository root. See the [ADR Index](/ai-gateway/developer-guide/adr-index/#creating-a-new-adr) for the template and process.