Architecture Decision Records

Architecture Decision Records (ADRs) capture important technical decisions, the context that shaped them, and the consequences maintainers should remember when changing the system. New ADRs should use the template below and keep the decision focused enough that a future contributor can understand the tradeoff quickly.

Template

# ADR-XXXX: Title

**Status:** Proposed | Accepted | Deprecated | Superseded
**Date:** YYYY-MM-DD
**Deciders:** @maintainer

## Context

What problem, constraint, or opportunity forced this decision?

## Decision

What did we choose?

## Consequences

What becomes easier, harder, or explicitly out of scope?

## Verification

How can a maintainer confirm the decision is still being followed?