One Big File Doesn't Scale


Claude Code reads a CLAUDE.md file at the root of your project. It's the primary way to give the agent project-specific instructions. And for small projects, it works great.

For this project, it didn't.

The root CLAUDE.md grew to cover architecture, testing conventions, API patterns, legacy patterns, SPA patterns,...