0000-architecture-decision-document-template.md

0000 Architecture Decision Record template

Status: [proposed | rejected | accepted | deprecated | superceded by ...]

Deciders: [list of everyone involved in decision]

Date: [YYYY-MM-DD last updated]

Technical Story: 1-2 line technical problem statement

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

• [driver 1, e.g., a force, facing concern, …]
• [driver 2, e.g., a force, facing concern, …]
• etc

Considered Options

• [option 1]
• [option 2]
• etc

Decision Outcome

Chosen option: "[option 1]", because [justification. e.g., only option, which meets k.o. criterion decision driver | which resolves force force | … | comes out best (see below)].

Positive consequences (optional)

Negative consequences (optional)

Pros and Cons of the options (optional)

[option 1]

• Good because [argument a]
• Good because [argument b]
• Bad because [argument c]