Skip to content

README.md

Latest commit

 

History

History
14 lines (9 loc) · 955 Bytes

README.md

File metadata and controls

14 lines (9 loc) · 955 Bytes
Raw

Architecture Decision Records

The durable record of why — the significant, hard-to-reverse choices behind this codebase. The engineering wiki explains what and how (non-obvious concepts) and links here for the why; the wiki is not itself the decision record.

Convention

  • One decision per file, NNNN-kebab-slug.md, numbered sequentially from 0001.
  • Minimal by default: Status + Context + Decision, plus Considered options / Consequences only when they earn their place.
  • Supersede, don't rewrite: mark an outdated ADR Superseded by ADR-NNNN and add a new one instead of editing the decision away.
  • Gate — record an ADR only when the decision is hard to reverse, surprising without context, and the result of a real trade-off. All three must hold.

Index

  • 0001 — Automate database migrations via an ArgoCD PreSync hook