# Architectural Decision Records

Point-in-time decisions that are hard to reverse or affect multiple parts of the system.

| ADR | Decision |
|-----|---------|
| [ADR-001-tool-persistence.md](ADR-001-tool-persistence.md) | Every CLI tool needs two things: a named volume (auth/config) AND a bootstrap install step (binary). Missing either = silent breakage on rebuild. |
| [ADR-002-documentation-structure.md](ADR-002-documentation-structure.md) | Diátaxis-based directory structure, project-scoped naming, and migration rules for the docs/ directory. |