Can I still edit CLAUDE.md directly?

Once initialized, CLAUDE.md becomes an auto-generated file. You should edit the individual files in .claude/rules/ and use /rules-merge to update the main file.

How does Rules Split Manager prevent CLAUDE.md bloat?

It splits the single CLAUDE.md file into multiple small files within the .claude/rules/ directory and only merges the essential manual rules back into the main file.

What happens if I haven't run /rules-init yet?

If the rules directory doesn't exist, the skill remains inactive and Claude Code will continue to operate with the standard single CLAUDE.md file.

Does this skill work with standard commands like /lessons?

Yes, it acts as a behavior modifier that automatically intercepts triad commands and redirects their output to specific files like 90-lessons-learned.md.

Is the split directory structure compatible with Git?

Yes, the .claude/rules/ directory and the generated CLAUDE.md should be committed to your repository so all team members share the same organized rules.

Rules Split Manager

Name: Rules Split Manager
Author: xtone

byxtone

•

Learning & Documentation

Organizes and modularizes project rules by splitting the CLAUDE.md file into structured, auto-merged configuration files.

Rules Split Manager is a specialized tool designed to solve the problem of bloated CLAUDE.md files in large-scale projects. By moving project guidelines into a dedicated .claude/rules/ directory, it allows developers to separate manual architectural rules from automated AI learning outputs like /lessons and /review-learn. The skill automatically redirects AI-generated insights to specific numbered files and re-generates a clean CLAUDE.md, ensuring that your project context remains organized, maintainable, and easy for both humans and AI to parse.

Key Features

01One-touch migration of existing CLAUDE.md files via /rules-init

023 GitHub stars

03Modular rule management with a structured 01-99 numbering convention

04Automatic redirection of /lessons and /review-learn to dedicated storage files

05Automated merging that compiles manual rules into a clean, read-only CLAUDE.md

06Health checks and status reports for rule integrity, line counts, and numbering

Use Cases

01Standardizing rule organization across team-based repositories for better documentation maintenance

02Preventing CLAUDE.md from becoming unreadable due to high-frequency AI learning updates

03Separating core project architectural rules from transient session-based learnings

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add xtone/ai_development_tools rules-split-manager

For use in Claude.ai and ChatGPT

Key Features

01One-touch migration of existing CLAUDE.md files via /rules-init

023 GitHub stars

03Modular rule management with a structured 01-99 numbering convention

04Automatic redirection of /lessons and /review-learn to dedicated storage files

05Automated merging that compiles manual rules into a clean, read-only CLAUDE.md

06Health checks and status reports for rule integrity, line counts, and numbering

Use Cases

01Standardizing rule organization across team-based repositories for better documentation maintenance

02Preventing CLAUDE.md from becoming unreadable due to high-frequency AI learning updates

03Separating core project architectural rules from transient session-based learnings

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add xtone/ai_development_tools rules-split-manager

For use in Claude.ai and ChatGPT