# Docs

This directory is the home for project documentation, including architecture governance artifacts added during the refactor.

## Folders

- `architecture/` — architecture design and structure docs.
- `boundaries/` — module boundaries and dependency direction docs.
- `contracts/` — design-by-contract specifications per boundary.
- `tests/` — architecture and boundary test strategy docs.
- `exceptions/` — quarantined allowlists with owner and expiry.
- `quality-gates/` — gate definitions and ratchet policy.
- `migration/` — parity harness plan and cutover phases.
- `runbooks/` — operational guides for violations and boundary-safe changes.
- `adr/` — architecture decision records.
