# Architectural decisions

Read the original decisions, their constraints and their recorded evidence.

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.

- [ADR-0001 — Stored file keys keep the user's filename](/docs/adr/0001-stored-file-keys-keep-the-user-s-filename)
- [ADR-0002 — Server-capable modules have no barrel](/docs/adr/0002-no-barrels-on-server-capable-modules)
- [Organizations are the tenant](/docs/adr/0003-organizations-are-the-tenant)
- [Payments: one entitlement read model, three provider modules](/docs/adr/0004-payments-providers)
- [Effect stays at the server edges](/docs/adr/0005-effect-boundary)
- [Todo imports and the PersistedQueue gate](/docs/adr/0006-effect-persisted-queue)
- [AI assistant and one tool catalog](/docs/adr/0007-ai-assistant-and-tool-catalog)
- [Documents and large uploads](/docs/adr/0008-documents-and-large-uploads)