Architecture decisions
Short records of the big calls that shaped this codebase. Each one captures the context, the alternatives we looked at, and why we picked what we picked.
Read these when you're about to change something and want to understand why it's the way it is.
| # | Decision |
|---|---|
| 0001 | Use a pnpm monorepo |
| 0002 | Wrap the LLM behind a provider interface |
| 0003 | Validate orders outside the AI (the guardrail) |
| 0004 | Phase 2 — RBAC, comments, mobile |
New decisions get the next number. Keep them short — context, decision, consequence. Don't write a thesis.