Skip to content

0001 — Record architecture decisions

  • Status: accepted
  • Date: 2026-07-27

Context

N-AALP makes several non-obvious, load-bearing choices. Future implementers and reviewers need to know not just what was decided but why, and what alternatives were rejected.

Decision

We keep Architecture Decision Records (ADRs) — one short document per load-bearing decision, with context, decision, and consequences. ADRs are numbered and dated and are part of the published documentation site.

Consequences

A reviewer can trace any surprising design choice to its rationale. New ADRs are added as decisions are made; existing ADRs are superseded, not rewritten.