adaptive-docs-extract

Refactor bloated AGENTS.md and CLAUDE.md root instructions by extracting topics into a three-layer adaptive docs system with on-demand docs/ai files and nested guardrails to reduce duplication and improve discovery.

A three-layer adaptive docs system structures project guidance into a concise root guide, on-demand documentation files in docs/ai, and nested AGENTS.md guardrails for high-risk directories to improve clarity and reuse.

Extract topics from root documentation by scanning AGENTS.md or CLAUDE.md for candidate subjects, categorizing them, generating docs/ai files with required YAML frontmatter, and updating reference tables to centralize guidance.

Yes, the adaptive docs extraction process coordinates steps through interactive AskUserQuestion prompts, supports optional resources like scripts and references, and proposes nested guardrails for high-risk workflows.

Use nested AGENTS.md guardrails when managing high-risk directories and complex workflows that require specific constraints, keeping the root AGENTS.md or CLAUDE.md file clean, concise, and agent-agnostic.