ADR-NNNN: Title of the decision

• Status: Proposed
• Date: YYYY-MM-DD
• Supersedes: link to the ADR this one replaces — omit the line unless it replaces an earlier decision.
• Superseded by: link to the ADR that replaced this one — leave the line out until that happens.

See the statuses for what each status means and when it changes.

Context

What is the issue that we’re seeing that is motivating this decision? Describe the forces at play, including technical, business, and team constraints.

Decision

State the decision clearly and concisely, in active voice: “We will …”.

Alternatives considered

What other options were on the table, and why were they not chosen? (Optional — omit if there was only one reasonable option.)

Consequences

What becomes easier or more difficult to do because of this change? Include trade-offs and any follow-up work this creates.