agent-md-refactor

Refactor bloated agent instruction files by splitting content into a minimal root and organized linked documentation using progressive disclosure. The process extracts universal rules and moves detailed instructions into categorized documents to keep the root file concise.

Progressive disclosure organizes agent instructions by keeping the root file minimal and easy to scan, while moving detailed instructions into linked, categorized documents. This structure surfaces universal rules immediately and hides complexity until needed.

Organize agent instructions through a five-phase process: contradiction discovery, essentials extraction, grouping, structuring, and deletion flagging. This extracts universal rules for the root file and moves detailed instructions into linked, categorized documents.

Yes, progressive disclosure refactoring includes a contradiction discovery phase that surfaces conflicting instructions within agent files. This happens during the essentials extraction and grouping stages before structuring the final linked documentation.

The best way to minimize root agent instruction files is extracting universal rules and moving detailed instructions into linked, categorized documents. Template-driven output and link verification ensure a coherent progressive disclosure structure while flagging redundant content for deletion.

Yes, progressive disclosure refactoring applies to AGENTS.md, CLAUDE.md, COPILOT.md and similar agent instruction files. It splits their content into a minimal root file and organized linked documentation regardless of the specific agent platform.