Skip to content

Architecture Decision Records

Architecture Decision Records describe accepted Tosumu architecture and the consequences of that choice. They are concise decision records, not design journals or implementation plans.

When To Add An ADR

Add or supersede an ADR when Tosumu accepts a durable decision about:

  • crate or subsystem ownership;
  • dependency direction;
  • on-disk compatibility or migration policy;
  • public provider or consumer boundaries;
  • security, integrity, durability, or recovery guarantees;
  • an architectural proposal concluded by an Architectural Review.

Use ADR-NNNN-short-title.md. Numbers are never reused. Accepted decisions remain in history when superseded.

Index