agent-md-refactor

Apply progressive disclosure by extracting essential instructions into a minimal root file under 50 lines, grouping related guidance into topic-specific linked files like testing.md, and flagging vague content for deletion to create a scalable documentation hierarchy.

Progressive disclosure for agent instruction files means structuring documentation as a minimal root file linking to self-contained, topic-specific files. This hierarchy prevents unwieldy documents, saves cognitive tokens, and makes relevant guidance easier to locate.

Identify core instructions for the root file, then group related rules into focused linked files like typescript.md, testing.md, code-style.md, git-workflow.md, and architecture.md. This creates a navigable, scalable file hierarchy for different topics.

Yes, this refactoring approach works with AGENTS.md, CLAUDE.md, COPILOT.md, and similar agent instruction files. It restructures any bloated agent documentation into a minimal root file and organized linked documentation hierarchy.

Clean up redundant agent documentation by identifying contradictions, flagging vague content for deletion, and extracting essentials into a root file. Group remaining valid instructions into self-contained linked files to eliminate conflicting guidance.