When should I split my CLAUDE.md file?

You should consider splitting your CLAUDE.md when it exceeds 300 lines, when multiple teams require different instructions, or when finding specific rules takes too long.

How does Claude discover the split instruction files?

Claude Code automatically reads files located in the .claude/ directory. This skill provides a structure for placing instruction files where Claude will find them without explicit loading.

What happens if two instruction files conflict?

This strategy establishes clear precedence: the root CLAUDE.md file has the highest priority, followed by concern-specific files, then module-level, and finally team-level files.

Can I split by both module and concern simultaneously?

It is highly recommended to pick a single axis (either Concern OR Module OR Team) to avoid overlapping ownership and contradictory rules.

Split Memory: Modular CLAUDE.md Strategy

Name: Split Memory: Modular CLAUDE.md Strategy
Author: codewithmukesh

bycodewithmukesh

•

189

•

Productivity & Workflow

Organizes and manages complex project instructions by splitting monolithic CLAUDE.md files into modular, domain-specific components.

Split Memory provides a standardized framework for scaling Claude Code instructions across large-scale projects and multi-team environments. It offers proven patterns for organizing instructions by concern, module, or team, ensuring Claude remains efficient and context-aware without hitting token or readability limits. By establishing clear precedence rules and a central index, this skill prevents instruction conflicts and helps maintain high-quality AI assistance as your codebase grows from a simple project into a complex enterprise solution.

Key Features

01Modular instruction management for files exceeding 300 lines

02Decision guide for identifying the optimal time to transition from monolithic to modular

03189 GitHub stars

04Predefined organizational patterns including Concern, Module, and Team axes

05Root-level indexing for centralized discovery of sub-instructions

06Conflict resolution framework with clear precedence rules

Use Cases

01Reducing instruction clutter by separating architecture, testing, and deployment rules

02Scaling AI instructions for enterprise-level modular monoliths or microservices

03Coordinating distinct coding standards across multiple specialized development teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codewithmukesh/dotnet-claude-kit split-memory

For use in Claude.ai and ChatGPT

Download Skill