agent-md-refactor

To refactor a large CLAUDE.md file, extract universal rules into a concise root document and group remaining guidelines into linked markdown sub-files. This progressive disclosure organization reduces context waste and surfaces important rules.

Progressive disclosure for agent instruction files is structuring documentation by splitting bloated root files into concise main documents with linked sub-files. This hierarchical structuring categorizes guidelines into logical modules like testing or typescript.

To find contradictions in agent documentation, use automated contradiction detection during the refactoring process. This surfaces conflicting instructions in files like COPILOT.md, allowing you to clarify rules and remove vague or redundant statements.

Yes, you can reorganize agent configuration files without external dependencies. The refactoring process performs essential extraction, categorization, and deletion recommendation natively to streamline markdown files like AGENTS.md.

You should clean up bloated agent docs when unstructured instruction files become difficult to maintain and cause context waste. Refactoring hides noise by performing hierarchical structuring and pulling universal rules to keep the root file minimal.