Skip to content

ADRs

This directory is reserved for backend architecture decision records going forward.

Historical ADR-like material already exists in:

  • docs/90_ops/decisions/

Use ADRs for decisions that materially affect:

  • runtime topology
  • storage and retrieval strategy
  • auth and role handling
  • ingestion contracts
  • billing behavior

Keep ADRs short, dated, and explicit about:

  • decision
  • context
  • alternatives considered
  • consequences

When an ADR is superseded, update the active architecture pages as well.