ADR-NNNN: <Title>

• Status: proposed | accepted | superseded by ADR-XXXX | deprecated
• Date: YYYY-MM-DD
• Deciders: <names / roles>

Context

What is the situation that prompted this decision? Include enough background that a future reader (or future you) can understand why the question even came up. Cite specific constraints, requirements, or incidents.

Decision

The decision itself, in one or two sentences. Lead with the answer.

Then expand: what specifically are we doing, what are we not doing, what does "this" actually mean in code / infrastructure terms.

Alternatives considered

For each real alternative:

Alt A — <name>

• What it is
• Why we didn't pick it (be specific; "more complex" is not a reason — what is complex and why does it matter)

Alt B — <name>

...

Consequences

Positive

• ...

Negative / trade-offs

• ...

Things we'll need to revisit

• Conditions under which we'd reverse this decision
• Open questions deferred to later

References

• Links to related docs, ADRs, external resources, discussions