agent-md-refactor

Split it by applying progressive disclosure principles to separate the monolithic instruction file into a minimal root file and categorized, linked sub-files, improving context efficiency and instruction clarity.

Progressive disclosure for agent instruction files is the practice of restructuring bloated configurations like AGENTS.md into a minimal root file that links to categorized sub-files, optimizing context efficiency and reducing wasted tokens.

Yes, contradiction detection identifies and flags conflicting instructions within your AGENTS.md before restructuring begins, ensuring logical categorization of technical guidelines and preventing contradictory or vague rules from persisting.

The best way to optimize context tokens is to refactor project configuration files into a modular documentation structure, reducing a 300-line monolithic root file to a 50-line version with dedicated files for each topic.

You need to refactor agent instructions into linked sub-files when your root configuration grows to hundreds of lines of mixed rules, wasting context tokens and making it difficult to maintain logical categorization of technical guidelines.