docs: add CLAUDE.md with architecture orientation
From the PR description
Summary
- Adds a top-level
CLAUDE.mdso Claude Code sessions get a fast architectural orientation instead of re-deriving it from scratch. - Covers: repo layout, common commands (with the no-test-runner heads-up), backend route/lib map, frontend
mikeApiclient pattern, DB notes, non-obvious env secrets (DOWNLOAD_SIGNING_SECRET,USER_API_KEYS_ENCRYPTION_SECRET), and gotchas (OpenNext/Workers, LibreOffice, AGPL). - Defers user-facing setup to
README.mdto avoid duplication.
Test plan
- Skim
CLAUDE.mdend-to-end; every section is something a coding agent (not an end user) needs. - Confirm no commands or paths were invented - each maps to scripts in
backend/package.json/frontend/package.jsonor to real files in the tree.
Our analysis
Add a CLAUDE.md orientation file for coding agents — read the full analysis →
Think the analysis missed something the PR description covers?
Capture this PR into my fork
Download a Markdown prompt that tells Claude how to port every
commit in this PR into your working tree. Run it via
claude -p < capture-pull-57.md from
inside the repo you want the changes in.