ADR-NNNN: Title

• Status: proposed | accepted | deprecated | superseded by ADR-MMMM
• Date: YYYY-MM-DD
• Deciders: GitHub handles
• Tags: comma-separated keywords

Context

What is the situation, the constraint, and the question we have to answer? Limit to ~10 lines — links to issues / docs / benchmarks belong in "References" below, not here.

Decision

What did we choose? Past tense. One paragraph.

Consequences

• Positive: …
• Negative: …
• Neutral / risks: …

Alternatives considered

Each alternative gets a one-paragraph summary and the reason it lost.

References

• Issue / PR / commit links
• External RFCs, papers, benchmarks