Treat CLAUDE.md like a migration script, not a README

I opened CLAUDE.md last week to ask an agent to fix a payments bug, and the first section described a folder layout we refactored away three sprints ago. The api/ directory that section kept pointing