NNNN — Title of the decision

Status: Proposed | Accepted | Superseded by NNNN | Deprecated

Date: YYYY-MM-DD

ADO work item: AB#

Deciders: <!-- names or roles of people involved in the decision -->

---

Context

What is the situation, problem, or need that forces a decision? Describe the constraints — technical, organizational, financial, time — that apply. Be specific. A reader unfamiliar with the project should understand why a choice must be made.

Decision

State the decision clearly and precisely in one or two sentences.

We will use X for Y because Z.

Alternatives considered

List every alternative that was seriously evaluated. For each one, give a brief rationale for why it was not chosen.

Option	Pros	Cons	Why not chosen
Option A (chosen)	...	...	— chosen
Option B	...	...	...
Option C	...	...	...

Consequences

Positive

• What does this decision enable or improve?

Negative / trade-offs

• What does this decision constrain or make harder?
• What follow-on work does it create?

Risks

• What could go wrong? How will it be mitigated?

References

• Link to relevant research, docs, or prior discussions.
• Link to the ADO work item and any related ADRs.