Skip to content

Architecture Decision Records

ADRs capture important architectural decisions with their context and consequences.


What is an ADR?

An Architecture Decision Record documents:

  • Context — Why was this decision needed?
  • Decision — What was decided?
  • Consequences — What are the tradeoffs?

Decision Log

# Decision Status
No ADRs recorded yet

Note: Existing architectural decisions will be documented as ADRs.


Creating an ADR

# ADR-NNN: Short Title

## Status
Proposed | Accepted | Deprecated | Superseded

## Context
Why is this decision needed?

## Decision
What was decided?

## Consequences
What are the positive and negative outcomes?

See also: Architecture for the current system design.