agent-md-refactor

To refactor a long CLAUDE.md file, this Skill splits monolithic instructions into a concise root file and linked markdown documents using progressive disclosure. It extracts essential root instructions and categorizes remaining details into linked files.

Progressive disclosure for agent instructions minimizes the root file to essential information while hiding detailed rules in linked markdown documents. This structured format reduces context window waste and makes specific rules easier to find.

You can resolve contradictions in agent instruction files during the initial phases of refactoring. The process identifies conflicting instructions before restructuring, extracts essential rules, and flags redundant or vague instructions for deletion.

Yes, the refactoring process supports common agent instruction file names including AGENTS.md and CLAUDE.md. It restructures these monolithic files into a new hierarchy of focused markdown files within a dedicated directory.

The best way to organize code organization rules is through intelligent categorization into logical files, such as separating testing and typescript rules. This groups related instructions together and creates a new file hierarchy for efficient management.