Date: YYYY-MM-DD | Status: [Proposed | Accepted | Deprecated | Superseded]
Deciders: [List key decision-makers]
Keywords: [e.g., maturity-model, versioning, governance, api, security]
Work Streams Impacted: [e.g., Cloud, Discovery, DaMaSC]
Products Affected: [e.g., Beacon v2, TRS, Refget]
[Describe the problem and why a decision is needed. What forces are at play?]
The Problem:
- [Describe the issue requiring a decision]
Alternatives Considered:
-
[Alternative 1]
- ✅ [Pro]
- ❌ [Con]
-
[Alternative 2]
- ✅ [Pro]
- ❌ [Con]
-
[Chosen Alternative]
- ✅ [Pro]
- ✅ [Another pro]
[State the decision clearly. Use active voice and full sentences.]
Key Points:
- [Point 1]
- [Point 2]
✅ [Benefit 1] ✅ [Benefit 2]
❌ [Cost/drawback 1] ❌ [Cost/drawback 2]
Risk: [Description]
- Mitigation: [How to address]
- Full Policy: [Link to detailed documentation]
- Related ADRs: [Links to related decisions]
- Examples: [Links to implementations]
[Any additional context, rationale, or future considerations]