Skip to content

Architecture decisions

Gaby keeps a thin ADR (architecture decision record) trail. Each ADR captures one decision, its motivation, and the alternatives considered.

Date Decision
2026-04-18 Widget uses polling, not SSE
2026-04-15 Dry-run is not a scope lane

Conventions:

  • Filename: YYYY-MM-DD-kebab-title.md.
  • One markdown file per decision.
  • Status section: Proposed / Accepted / Superseded by … / Deprecated.
  • Keep them short. If an ADR runs longer than a screen, it's probably two decisions.