Refactor the user's AGENTS.md or CLAUDE.md to follow progressive disclosure. Use the file named in the arguments, else the one in the repo root. If both exist and one is only an @AGENTS.md import, treat AGENTS.md as the source.

Subagents cannot ask the user questions, so they report back and you ask.

Steps

Find contradictions. Have a subagent list instructions that conflict, including with imported files and linked docs. Ask the user which version to keep for each, then apply their answers to every later step.
Identify the essentials. Keep only what belongs in the root file:
- One-sentence project description
- Package manager (if not npm)
- Non-standard build, test or typecheck commands
- Anything relevant to every single task
Group the rest. Sort remaining instructions into logical categories (TypeScript conventions, testing patterns, API design, Git workflow). Each group becomes its own markdown file.

agents-review

Steps