Skip to content

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?

Released under the MIT License.