⚖️ Architecture Decision Records
An ADR (Architecture Decision Record) captures a significant technical decision: what was decided, why, and what alternatives were considered.
Why we write ADRs
- New engineers understand why the codebase is the way it is
- We avoid relitigating decided questions
- Future decisions are made with full context
Status lifecycle
Proposed → Accepted → Deprecated → Superseded by ADR-XXX
Index
| # | Title | Status | Date |
|---|---|---|---|
| ADR-001 | Deploy on AWS ECS Fargate | Accepted | 2024-08-01 |
tip
Use the ADR template for new decisions. Link to the Jira ticket or RFC that prompted the decision.