# 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