71 lines
1.5 KiB
Markdown
71 lines
1.5 KiB
Markdown
# ADR-{{NUMBER}}: {{TITLE}}
|
|
|
|
**Date:** {{DATE}} | **Status:** {{STATUS}} | **Category:** {{CATEGORY}} | **Decision Makers:** {{DECISION_MAKERS}}
|
|
|
|
<!-- SCOPE: Architecture Decision Record for ONE specific technical decision ONLY. Contains context, decision, rationale, consequences, alternatives (2 with pros/cons). -->
|
|
<!-- DO NOT add here: Implementation code → Task descriptions, Requirements → Requirements.md, Multiple decisions → Create separate ADRs, Architecture diagrams → Architecture.md -->
|
|
|
|
---
|
|
|
|
## Context
|
|
|
|
{{CONTEXT}}
|
|
|
|
(2-3 sentences: background, problem, constraints, forces driving this decision)
|
|
|
|
---
|
|
|
|
## Decision
|
|
|
|
{{DECISION}}
|
|
|
|
(1-2 sentences: clear statement of what we decided, including version/constraints if applicable)
|
|
|
|
---
|
|
|
|
## Rationale
|
|
|
|
{{RATIONALE}}
|
|
|
|
(2-3 key reasons WHY we chose this solution)
|
|
|
|
---
|
|
|
|
## Consequences
|
|
|
|
**Positive:**
|
|
{{POSITIVE_CONSEQUENCES}}
|
|
|
|
(2-4 bullets: benefits, advantages)
|
|
|
|
**Negative:**
|
|
{{NEGATIVE_CONSEQUENCES}}
|
|
|
|
(2-4 bullets: trade-offs, costs, technical debt)
|
|
|
|
---
|
|
|
|
## Alternatives Considered
|
|
|
|
| Alternative | Pros | Cons | Why Rejected |
|
|
|-------------|------|------|--------------|
|
|
| {{ALT_1_NAME}} | {{ALT_1_PROS}} | {{ALT_1_CONS}} | {{ALT_1_REJECTION}} |
|
|
| {{ALT_2_NAME}} | {{ALT_2_PROS}} | {{ALT_2_CONS}} | {{ALT_2_REJECTION}} |
|
|
|
|
---
|
|
|
|
## Related Decisions
|
|
|
|
{{RELATED_DECISIONS}}
|
|
|
|
(Optional: ADR-001, ADR-003)
|
|
|
|
---
|
|
|
|
**Last Updated:** {{DATE}}
|
|
|
|
---
|
|
|
|
**ADR Template Version:** 3.0.0 (With Categorization)
|
|
**Template Last Updated:** 2025-11-05
|