Skip to content

Architectural Decision Records

ADRs codify the scope invariants of nubos-pilot. Each ADR is authoritative for the constraint it documents. Decisions are superseded by new ADRs, never rewritten.

Status lifecycle

  1. Proposed — authored but not yet accepted; subject to revision during review.
  2. Accepted — decision is binding; downstream work consumes the invariant as-is.
  3. Deprecated — superseded by a later ADR (referenced via Supersedes NNNN); retained for history.

An ADR may enter directly as Accepted when ratified at authoring time. ADRs are append-only — a superseded ADR is never rewritten; a new ADR with a higher number references it via its Supersedes line.

Numbering

ADRs follow the pattern NNNN-kebab-title.md with a zero-padded four-digit sequence starting at 0001. Numbers are monotonically incremented — no skips, no re-use — so cross-references (e.g. ADR-0003) stay stable across the project's lifetime.

Index

ADRTitleStatus
0001No-Daemon InvariantAccepted
0002Zero Runtime DependenciesAccepted (amended by 0006)
0003Max Six Unit-TypesAccepted
0004Atomic Commit per UnitAccepted
0005Three Orthogonal File-TreesAccepted
0006Accept yaml@^2.8 (Amendment to 0002)Accepted