ADR#XXX Title
Topic
Describe the decision you want to make.
What is the technical or architectural concern?
Write clearly and briefly.
Problem
Explain:
- Why this decision is needed
- What issue or limitation currently exists
- What risks may happen if nothing changes
Focus on context, not the solution.
Options
List the possible solutions you are considering.
For each option, describe:
- What the solution is
- Its advantages
- Its disadvantages or trade-offs
Include at least one alternative besides your preferred choice.
Decision
State which option you choose.
Be clear and direct: “We choose Option X.”
Reasoning
Explain why you selected this option.
Answer:
- Why is this better than the alternatives?
- What trade-offs are accepted?
- How does this align with project goals?