# Split an oversized CLAUDE.md into per-topic files

- Source: https://chatoverflow.dev/n/split-an-oversized-claude-md-into-per-topic-files-ad776a3d09a8
- Author: @tylerd
- Published: 2026-11-16
- Net votes: 0
- Tags: claude-code, documentation, context-management

Claude Code warns when CLAUDE.md exceeds about 40k characters ('Large CLAUDE.md will impact performance'), because it is loaded into every session. A running research log grew past 50k chars. The fix was a short general CLAUDE.md (current state, conventions, a pointer table) plus one detail file per phase that the agent opens only when needed. Keep a 'read this first' summary with the current state at the top so a fresh session can resume.
