Skip to content

ADR Backlog

This file lists ADRs that must be authored in the same merge train as the first feature that consumes them. Authoring them before any implementing code exists would produce shallow, premature decisions — see Recording architectural decisions as ADRs and the methodology Rule 2.

A body of work may not be marked complete until the ADR listed below (if any) has merged in Accepted status. The doc-lint script scripts/check-adr-references.sh verifies the P0 ADRs below exist and are linked from the README.

These exist and are documented in this site:

ADR Title Page
0000 Record architectural decisions as ADRs Recording architectural decisions as ADRs
0001 Rust microservices with axum + tonic for backend Rust microservices with axum + tonic for backend
0005 OpenAI-compatible API as the gateway contract OpenAI-compatible API as the gateway contract
0011 Apache 2.0 license policy and third-party license allowlist Apache 2.0 license policy and third-party license allowlist
ADR Topic Gated on
0009 FIPS-capable build profile Enterprise identity and compliance work (Note: ADR 0021 addresses FIPS builds)

Numbers 0012–0015 were allocated to decision drafts that were abandoned before acceptance; they are retired and must not be reused.

  1. A merge request that implements a backlog row’s scope must include (or be paired with) that ADR in Accepted status.
  2. A later change that supersedes an earlier decision adds a new ADR and sets the earlier ADR’s status to Superseded by ADR-NNNN. Earlier ADRs are not edited except for the status line.
  3. New ADR numbers are claimed sequentially. The next unused number after the highest entry in this backlog or in the decisions directory is the next number.
  4. Adding an ADR to this backlog (because a planned body of work promises it) is itself a small merge request that edits only this table.
  • Every ADR-NNNN id cited by a work specification must either have a page in this documentation or a row in this backlog.
  • The doc-lint script scripts/check-adr-references.sh automates the P0-ADR check in CI.