# Architecture Decision Records (ADRs)

Canonical directory for all ADRs.

All current ADR links should target this directory as `docs/adr/...`.
`docs/decisions/...` was the historical path and must not be used for new
references.

Runtime execution contracts live in `docs/specs/runtime_contracts.md`; ADRs
may cite that spec when a decision adds or changes a runtime invariant.