Architecture decisions
An Architecture Decision Record (ADR) captures a significant decision, the context behind it, and its consequences. Change a handbook standard by adding or superseding an ADR.
Decision log
| ADR | Title | Status |
|---|---|---|
| ADR-001 | Handbook as source of truth | Accepted |
| ADR-002 | Git branching model | Superseded by ADR-007 |
| ADR-003 | Alembic for database migrations | Accepted |
| ADR-004 | Enforced 80% coverage gate | Accepted |
| ADR-005 | Lambda container image for the lean profile API | Accepted |
| ADR-006 | Cloudflare static hosting for the engineering handbook | Accepted; CI branch targets amended by ADR-007 |
| ADR-007 | Main-only Git workflow and project-specific releases | Accepted |
| ADR-008 | Modular monolith by default | Proposed |
Process
- Name files
adr-NNN-short-slug.md, numbered sequentially. - Use the template.
- Status lifecycle:
Proposed→Accepted→Superseded by ADR-NNNorDeprecated. - Never rewrite an accepted ADR's decision. Add a new ADR that supersedes it.