Architecture Decision Records
September 5, 2026 ยท View on GitHub
Decisions that shape architecture, workflow, or tooling are recorded here so humans and agents share the same memory. Each ADR follows 0000-template.md: context, options considered with trade-offs, decision, consequences. One page max.
Index
| ADR | Title | Status | Date |
|---|---|---|---|
| 0001 | Development workflow: trunk-based, conventional commits, issues as backlog | accepted | 2026-07-26 |
| 0002 | GitHub Project board as execution view of the backlog | accepted | 2026-07-26 |
| 0003 | Same REST API in .NET, Go and C++ behind Nginx | accepted | 2026-07-28 |
| 0004 | Dual database providers with a dedicated migrations runner | accepted | 2026-07-28 |
| 0005 | Solidity contracts with a local Ganache node in the stack | accepted | 2026-07-28 |
| 0006 | Product docs and PRD workflow | accepted | 2026-07-28 |
| 0007 | Agent contribution workflow: worktrees, quality gates, e2e upkeep | accepted | 2026-08-18 |
| 0008 | PR review agent via Claude Code Action | accepted | 2026-08-22 |
| 0009 | Flutter API client on the http package | accepted | 2026-08-22 |
| 0010 | CodeQL analyzes only the languages a pull request changed | accepted | 2026-09-05 |
| 0011 | One validation and error contract across the .NET, Go and C++ APIs | accepted | 2026-09-05 |
| 0012 | In-browser mock API for the GitHub Pages demo | accepted | 2026-09-05 |
| 0013 | In-place overlays for reminder create, edit and delete | accepted | 2026-09-05 |
| 0014 | Android network security config with a loopback-only cleartext allow-list | accepted | 2026-09-05 |
Process
- Ideas that need debate start as a GitHub Discussion (RFC).
- Draft the ADR as
NNNN-short-title.mdwith statusproposed, in a PR. - Review and merge: status becomes
accepted. - Superseding: the new ADR references the old one; the old one gets status
superseded by ADR-NNNN. - Add every new ADR to the index table above in the same PR.