agents-md:refactor

To refactor a large AGENTS.md file, you can split its inline sections into targeted nested AGENTS.md files under appropriate subdirectories, keeping the root file concise with an updated context map for navigation.

You should split your root AGENTS.md into nested files when the document grows bloated and unwieldy, making it hard to locate relevant sections or subtopics across multiple project modules.

The best way to reduce root complexity in AGENTS.md documentation is to generate a refactoring plan that moves module-specific content into nested files, keeping each nested file under 100 lines.

You can generate a modularization plan for AGENTS.md by analyzing the root file to measure length, identify inline sections, and detect opportunities for nesting content within specific subdirectories.

Yes, when reorganizing nested AGENTS.md files, the approach applies a limitation of keeping each newly created nested file under 100 lines to maintain readability and reduce complexity.