​

NNNN. Short, decision-style title (verb phrase)

​

Context and problem statement

What forces are in tension? What makes this decision non-obvious? Two to five sentences. State the problem, not the answer.

​

Decision drivers

• Constraint or quality attribute 1 (e.g. “must work offline”)
• Constraint or quality attribute 2
• …

​

Considered options

1. Option A: short label. One sentence.
2. Option B: short label. One sentence.
3. Option C: short label. One sentence.

​

Decision outcome

Chosen option: Option X, because (one-sentence justification).

​

Positive consequences

• What becomes easier or possible because of this choice.

​

Negative consequences

• What becomes harder, more expensive, or constrained.
• Risks to monitor.

​

Pros and cons of the options

​

Option A

• + …
• − …

​

Option B

• + …
• − …

​

Option C

• + …
• − …

​

Links

• Related ADRs: NNNN-…
• Related issues / PRs: #NN
• External references: …