ADR-0001: Template
| Metadata | Value |
|---|---|
| Status | Proposed | Accepted | Superseded | Deprecated |
| Date | YYYY-MM-DD |
| Author(s) | @username |
| Supersedes | (ADR number, if any) |
| Superseded by | (ADR number, if any) |
Context
What is the situation? What problem or need triggered this decision?
- Background information
- Constraints (time, budget, technical, organizational)
- Forces at play
Decision
What is the change being proposed or adopted?
We will [decision statement].
Consequences
Positive
- Benefit 1
- Benefit 2
Negative
- Trade-off 1 (the “tax” we accept)
- Trade-off 2
Neutral / Follow-ups
- Required migration or cleanup
- Documentation updates
- Training needs
Alternatives Considered
Alternative A: [Name]
Brief description
- ✅ Pros
- ❌ Cons
- Why rejected: Reason
Alternative B: [Name]
Brief description
- ✅ Pros
- ❌ Cons
- Why rejected: Reason