Decisions
Decisions
Architecture Decision Records
The architecture decision log.
Decisions retain their original dates and statuses. These summaries describe the choices and trade-offs in light of the current code. Superseded decisions remain in the log. The former hosting and observability provider records were retired during reorganization; they remain available in Git history.
| Decision | Date | Status |
|---|---|---|
| 0001 - Rewrite as services | 2025-12-25 | Superseded in part by ADR 0005; the rewrite and service boundaries remain. |
| 0002 - Go for services | 2026-01-04 | Accepted; refined by ADR 0005. |
| 0003 - NATS for service communication | 2026-05-23 | Accepted. |
| 0004 - MySQL for durable state | 2026-05-23 | Accepted. |
| 0005 - Elixir for Twitch ingress | 2026-05-23 | Accepted; supersedes ADR 0001 in part. |
| 0006 - Data service ownership | 2026-06-09 | Accepted. |
| 0007 - Cache and write-behind | 2026-06-09 | Accepted. |
| 0008 - Shared read projection | 2026-06-09 | Accepted. |
| 0009 - Transactions owns giveaway awards | 2026-09-15 | Accepted and implemented; fulfillment paths have separate gates. |
| 0010 - Kit owns the public variable inventory | 2026-09-18 | Accepted and implemented. |
To add a decision, run bun run adr:new "Short title" from web/docs/, then add its translation in fr/adr/ with the same number and filename. Reserve ADRs for choices that are costly to reverse, non-obvious and involve a real trade-off.