1. Record architecture decisions

Date: 2026-02-08

Status

Accepted

Context

We need to record the architectural decisions made on this project in a single, version-controlled place.

Decision

We will use Architecture Decision Records (ADRs), as described by Michael Nygard (http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions), and manage them with adr-tools in the directory docs/adr.

All new ADRs are created here. Existing ADRs in backend apps (backend/narmak_v2/app/*/ADR.md) remain as reference; cross-cutting and new decisions are recorded in docs/adr with numbered files (0002-..., 0003-...).

Consequences

• Single place for architecture decisions: docs/adr/
• CLI adr new "Title" creates the next numbered ADR
• .adr-dir in project root points to docs/adr (required by adr-tools)