ADR-NNNN: Title¶

Status: Proposed | Accepted | Deprecated | Superseded by ADR-XXXX
Date: YYYY-MM-DD
Spec section: (e.g., Section 3.2.7)

Context¶

What is the problem or question this decision addresses? Include constraints, prior art, and any standards we are aligning with.

Decision¶

What did we decide? State it as a clear directive.

Rationale¶

Why this option over the alternatives? Include the tradeoffs explicitly.

Alternatives considered¶

What else was on the table and why was it rejected?

Consequences¶

What becomes easier or harder as a result of this decision? What does a future maintainer need to know?

References¶

Links to relevant RFCs, papers, or prior art.