The pages below render the Markdown files in docs/adr directly. The decision records are the source of truth; feature guides explain how to work within them.
Each record starts with a status line: the status, the date it was accepted and, where it applies, the record that amends or supersedes it. An accepted decision changes only through a new record or a dated clarification.
| ADR | Decision | Status |
|---|---|---|
| 0001 | Stored file keys keep the user's filename | accepted · 2026-07-13 |
| 0002 | Server-capable modules have no barrel | accepted · 2026-07-30 |
| 0003 | Organizations are the tenant | accepted · 2026-09-17 · amended by 0015 |
| 0004 | Payments: one entitlement read model, three provider modules | accepted · 2026-10-12 |
| 0005 | Effect stays at the server edges | accepted · 2026-10-12 · amended by 0010 |
| 0006 | Todo imports and the PersistedQueue gate | accepted · 2026-10-13 |
| 0007 | AI assistant and one tool catalog | accepted · 2026-10-14 |
| 0008 | Documents and direct uploads | accepted · 2026-10-15 |
| 0009 | Row-level security isolates Organizations | accepted · 2026-10-16 |
| 0010 | Procedures run one Effect program at their edge | accepted · 2026-10-17 · amends 0005 |
| 0011 | Backend features have a fixed file shape | accepted · 2026-10-17 · amended by 0013 |
| 0012 | Web features mirror the backend shape | accepted · 2026-10-17 |
| 0013 | Mobile features mirror the backend shape | accepted · 2026-10-17 · amends 0011 |
| 0014 | Account emails in React Email | accepted · 2026-10-29 |
| 0015 | Server reads the session from the cookie cache | accepted · 2026-11-09 · amends 0003 |