# [ADR number, such as ADR-0007]: [Title]

Copy this file into your repository as docs/adr/[number]-[short-title].md for each architecturally significant decision. Fill in everything above the line when the decision is made, and return on the review date for the rest.

## Status

[Proposed | Accepted | Deprecated | Superseded]

## Date

[YYYY-MM-DD — when the status last changed]

## Deciders

[The people who made the call]

## Context

[The forces at play: technical, political, social, and project-specific. Describe them neutrally.]

## Decision

We will [the response to those forces, in active voice].

## Consequences

- Easier: [What this makes easier]
- Harder: [What this makes harder]
- Neutral: [What changes without being better or worse]

## Expected consequence

[One consequence stated so it can be checked, with a number or an observable sign]

## Review date

[YYYY-MM-DD — when that consequence should be visible]

---

Complete the remaining sections on the review date. Do not edit an accepted ADR to fit the result. If the decision changes, write a new ADR.

## What actually happened

[The result, recorded beside the prediction]

## Superseded by

[ADR-number of the replacing record, if any]