Architecture decision record

Record one architecture decision, its context and its consequences.

Engineering


Status

🟡 Proposed | 🟢 Accepted | ⚪ Superseded

Date

Deciders

@mention the people who make the decision

Context

The problem that needs a decision, and the facts and limits that affect it, for example the budget, the skills of the team or a deadline.

Decision

The decision in one or two sentences, in the active voice: "We will …".

Why you chose this option over the others.

Options considered

Option

Pros

Cons

An option that you considered, including the one you chose

What is good about it

What is bad about it

Consequences

✅ Good

  • What becomes easier because of this decision

⚠️ Bad

  • What becomes harder, and the costs or risks that you accept

Links

  • Link to the design doc, the ticket or the discussion
  • Link to the record that this decision replaces, or to the record that replaces it

Do not change an accepted record. To change the decision, write a new record, link the two records, and set the status of this one to Superseded.

allanswered knowledge management