ADR Template
Status: [Proposed | Accepted | Deprecated | Superseded] Date: YYYY-MM-DD Deciders: [List of people involved in the decision]
Context and Problem Statement
Section titled “Context and Problem Statement”[Describe the context and problem statement, e.g., in free form using two to three sentences. You may want to articulate the problem in form of a question.]
Decision Drivers
Section titled “Decision Drivers”- [Driver 1, e.g., a force, facing concern, …]
- [Driver 2, e.g., a force, facing concern, …]
- [Driver N, e.g., a force, facing concern, …]
Considered Options
Section titled “Considered Options”- [Option 1]
- [Option 2]
- [Option 3]
Decision Outcome
Section titled “Decision Outcome”Chosen option: “[Option X]”, because [justification. e.g., only option that meets k.o. criterion decision driver | which resolves force | … | comes out best (see below)].
Positive Consequences
Section titled “Positive Consequences”- [e.g., improvement of quality attribute satisfaction, follow-up decisions required, …]
- […]
Negative Consequences
Section titled “Negative Consequences”- [e.g., compromising quality attribute, follow-up decisions required, …]
- […]
Pros and Cons of the Options
Section titled “Pros and Cons of the Options”[Option 1]
Section titled “[Option 1]”[Example | Description | pointer to more information | …]
- Good: [Advantage 1, …]
- Bad: [Disadvantage 1, …]
[Option 2]
Section titled “[Option 2]”- Good: [Advantage 1, …]
- Bad: [Disadvantage 1, …]
[Option 3]
Section titled “[Option 3]”- Good: [Advantage 1, …]
- Bad: [Disadvantage 1, …]
- [Link type] [Link to ADR]
- [Link type] [Link to issue or external resource]
[Additional notes or context that doesn’t fit elsewhere]