Skip to main content

ADR

Architecture Decision Record. A short document that captures an important technical or organizational decision: the context in which it was made, the alternatives considered, and the accepted consequences.

ADRs are immutable once accepted — if the context changes, a new ADR is written that supersedes the previous one. They are never silently edited.

On this site​

  • They live in /docs/adrs/.
  • Each ADR links to its Discussion on GitHub, where the permanent conversation about the topic takes place.
  • They are created with the /adr slash-command in a Discussion under the Ideas category.

See also​