agent-md-refactor

Refactoring bloated agent instruction files with progressive disclosure creates a minimal root file that links to categorized markdown sub-files, replacing monolithic documentation with organized, modular guidance for easier maintenance.

Progressive disclosure for agent documentation modularization keeps root instruction files minimal while moving detailed guidance into linked, topic-specific markdown files like typescript.md or testing.md that override defaults where needed.

Yes, you can split CLAUDE.md and .cursorrules files into modular subdirectory documents. The refactoring process works across Claude, Cursor, GitHub Copilot, and Windsurf ecosystems by creating linked categorized guidance files.

Yes, this approach works with GitHub Copilot and Windsurf agent ecosystems. It supports cross-agent compatibility for CLAUDE.md, .cursorrules, .github/, and .windsurfrules files by applying structured refactoring across different agent systems.

The best way to split monolithic agent docs is structured refactoring: generate a minimal root file pointing to topic-specific markdown files such as code-style.md, git-workflow.md, and architecture.md, ensuring progressive disclosure across directories.

You should modularize agent instruction docs when files become bloated and hard to maintain, requiring progressive disclosure to split monolithic structures into categorized, linked documents for easier updates and actionable instructions.