# Architecture Decision Records

This directory contains Architecture Decision Records (ADRs) for this repository.

## Rules

1. Use `ADR-NNNN-short-title.md` names with four-digit numbers.
2. New ADRs start as `Proposed`.
3. `Accepted` ADRs are immutable. If the decision changes, create a new ADR and mark the old ADR as superseded by reference, not by editing its accepted content.
4. Architectural PRs must add or update an ADR before merge.
5. Reviews must check ADR correctness, evidence, trade-offs, and compliance — not just presence.

## Template

Use [`TEMPLATE.md`](./TEMPLATE.md).

## Tooling

See [`TOOLING.md`](./TOOLING.md) for `adrs`, `adr-kit`, and AI harness setup.
