ADR NNNN — Title

• Status: Proposed | Accepted | Superseded by ADR XXXX
• Date: YYYY-MM-DD
• Deciders: @handle, @handle

Context

What problem are we solving? What constraints exist? What prompted this decision? Include links to prior discussion, issues, or PRs.

Decision

What did we choose, and — briefly — why. One paragraph max.

Consequences

• Positive: what gets better
• Negative: what trade-offs we accepted
• Neutral: what changes without being strictly better or worse
• Affected components / owners: who has to do something as a result

Alternatives considered

List and tersely describe the options we rejected, with one-line reasons.