docs: add CLAUDE.md with architecture orientation
From the PR description
Adds top-level CLAUDE.md so Claude Code sessions get a fast architectural orientation. Defers user setup to README.md to avoid duplication.
Our analysis
Add CLAUDE.md for fast Claude Code orientation — 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-1.md from
inside the repo you want the changes in.