Architecture Decision Record (/adr)

An Architecture Decision Record (ADR) is a short document that captures an important architectural decision made for a software system, along with the reasoning behind it and its consequences.

The goal is to answer future questions like:

  • Why did we choose this approach?
  • What alternatives did we consider?
  • What trade-offs did we accept?

Instead of relying on team memory or old chat messages, the decision is documented in a simple, searchable format.

Written on July 31, 2026, Last update on
architecture