Skip to content

ADR 0001: Record architecture decisions

  • Status: Accepted
  • Date: 2026-09-11

Context

Keferboeck Ltd is built and operated by a very small team with AI assistance across many parallel sessions. Decisions made in one conversation are invisible to the next unless they are written down somewhere durable and public to the team.

Decision

Every significant architecture decision is recorded as a numbered ADR in this repository, using the template. ADRs are immutable: when a decision changes, a new ADR supersedes the old one.

Consequences

The why survives context loss. Reading adr/ is the fastest onboarding there is. The cost is the discipline of writing them, which the PR template enforces.