agent-md-refactor

Progressive disclosure splits monolithic agent instruction files into a minimal root containing universal rules and categorized linked guidance files like typescript.md or testing.md. This structure reduces context bloat by loading specific instructions only when needed.

Organizing agent instructions involves a structured reorganization that detects contradictions, extracts essentials, and categorizes content into linked files like code-style.md and architecture.md. This creates clear navigation for scalable maintenance and onboarding.

Yes, the refactoring process applies to monolithic files like COPILOT.md, AGENTS.md, and CLAUDE.md across software projects. It handles long-running agent configurations by generating a structured, linked file system with verification checks.

Minimizing root agent instructions requires extracting universal rules that apply to all tasks into the root file, then moving specific guidance into categorized linked files. This progressive disclosure approach maintains accessibility while reducing root file size.