ADR-0001: Record architecture decisions
Synced read-only from
/home/synnet/synvirt-platform/docs-internal/adr/0001-record-architecture-decisions.md. Edit at the source, not here.
ADR-0001: Record architecture decisions
Section titled “ADR-0001: Record architecture decisions”- Status: Accepted
- Date: 2026-06-28
Context
Section titled “Context”We need a durable, low-ceremony record of blocking architectural decisions
(identity, storage, ingress, data layout) since issues/roadmap live in
docs-internal/ on a plain SSH git remote (no Gitea UI).
Decision
Section titled “Decision”Use lightweight ADRs in docs-internal/adr/, numbered sequentially
(NNNN-title.md). One decision per file. Status one of: Proposed, Accepted,
Superseded (link the superseding ADR). Keep them short and factual; describe
behavior and invariants, not internal build/fix references.
Consequences
Section titled “Consequences”- Decisions are reviewable in the same repo as the code they govern.
- New contributors can read the ADR set to understand “why”.
- Superseding (not editing) preserves history.