Architecture decision records
An architecture decision record (ADR) captures a significant decision, the alternatives we considered, and why we chose what we chose. ADRs are immutable once merged — if we change our mind, we write a new ADR that supersedes the old one.
ADRs live under
docs/adr/
in the source tree.
Currently merged ADRs
Section titled “Currently merged ADRs”| # | Title | Status |
|---|---|---|
| 0001 | rettx is the rettX control-plane repo | Accepted |
| 0002 | Gap-analysis-first pipeline for cross-cutting work | Accepted |
| 0003 | In-app vs email content model for the Message Center | Accepted |
| 0004 | Message Center launches with no historical backfill | Accepted |
| 0005 | Message Center rollout: per-user pilot, then default-on for all | Accepted — implemented 2026-06-25 |
| 0006 | Message Center template store: multi-channel layout & naming | Accepted (2026-07-11) |
| 0007 | AI code-review custom instructions across the ecosystem | Accepted (2026-07-11) |
| 0008 | Retire the autonomous Squad/Ralph agent system | Accepted (2026-07-11) |
| 0009 | Pulse menstrual period modelled as start + duration | Proposed (2026-07-22) |
| 0010 | Pulse sleep entry: total duration + quality, with input-only bedtime/wake | Proposed (2026-07-22) |
| 0011 | Narrow pulse contributor scope for multi-caregiver Pulse contribution | Proposed (2026-07-26) |
| 0012 | Admin RBAC: Entra App Roles for membership + super_admin-configurable capabilities | Proposed (2026-07-26) |
| 0013 | Admin-domain data lives in a dedicated Cosmos database (rettxadmindb) | Proposed (2026-07-26) |
| 0014 | iOS app via Capacitor, built on GitHub Actions macOS runners | Proposed (2026-07-28) |
| 0015 | Medication is a dated regimen, not a Pulse event | Proposed (2026-08-01) |