ADR-NNN: Title

Status: Accepted | Deferred | Superseded Date: YYYY-MM-DD Context: What prompted this decision — the problem, constraint, or opportunity that required a choice.

At a glance

What it decides: one or two plain-language sentences. If the status is Proposed/Recommended say it's not yet in force; if Deferred, name the concrete revisit trigger.

• the core mechanism
• the main alternative rejected
• the cost / risk / trigger
• (3–5 bullets total — the "I have 20 seconds" summary. Bold the lead phrase of each.)

Decision

What we decided to do.

Rationale

Why this approach was chosen over alternatives. Include data, constraints, or principles that drove the decision.

Alternatives Considered

• Alternative A: Brief description and why it was rejected.
• Alternative B: Brief description and why it was rejected.

Discussion

Key trade-offs debated, pushback raised, and how the final decision was reached. Capture the deliberation so future readers understand not just what was decided but how we got there.

Consequences

• What changes as a result of this decision
• New constraints or trade-offs introduced
• What to watch for or revisit later

Key files: - path/to/file.ts — description of relevance