What problem does it solve?
It solves the problem of monolithic CLAUDE instruction files becoming too long, hard to navigate, and prone to conflicting guidance.
Core Features & Use Cases
- Modular instruction organization: Split one large instruction file into multiple files grouped by concern, module, or team.
- Clear loading strategy: Use Claude’s
.claude/ directory discovery so the right instructions are available without manual juggling.
- Conflict prevention via precedence rules: Apply a defined priority order so overlapping rules don’t create unpredictable behavior.
- Guidance for when to split: Recommend splitting only when it improves maintainability (e.g., over ~300 lines or multiple teams need different guidance).
Quick Start
When your CLAUDE.md grows beyond about 300 lines or you need different guidance for multiple teams, split it into a concise root index plus topic files under .claude/instructions/ and ensure root rules have the highest precedence.