# Architecture decision records

ADRs record a decision and the reasoning behind it, so the next person reading the code knows why it is the way it is rather than guessing. One file per decision, named `NNNN-short-title.md` from [`0000-template.md`](0000-template.md).

A decision that came out of an [RFC](../rfcs/) is worth an ADR once it is settled, as is any decision a future contributor would otherwise have to reverse-engineer. Keep them short.

A record is not rewritten when the decision later changes: a new ADR supersedes it, and the old one is marked `Status: Superseded by NNNN`.

## Index

<!-- Accepted ADRs are listed here as they land. -->
