DEV Community
•
2026-04-08 15:46
Building the Agent Harness: Subdirectory CLAUDE.md Files
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, service design, migration strategy, authoriz...