<quick_start>
- Identify whether the user wants a review, a rewrite proposal, or an in-repo refactor.
- Read the current AGENTS.md content and classify each instruction as root-essential, topic-specific, conflicting, redundant, vague, or stale.
- Keep only universal instructions in the root file, move the rest into topic docs, and surface any contradictions before editing. </quick_start>
<essential_principles> The root AGENTS.md should contain only what applies to every task: a one-line project description, package manager expectations if non-default, non-standard build or typecheck commands, and truly universal constraints.
If the user already gave enough context, skip extra questions and go straight to the matching workflow.
<reference_index> All shared guidance lives in references/:
Principles and heuristics: references/principles.md </reference_index>
<workflows_index> Review an AGENTS.md file, classify instructions, and propose a minimal split. Inspect the repo and rewrite AGENTS.md files in place. </workflows_index>
<success_criteria> The skill is complete when it can consistently:
- identify contradictions before rewriting
- keep root AGENTS.md content minimal
- split topic-specific guidance into separate docs
- flag redundant, vague, and stale instructions for deletion
- produce a clear proposed file structure or apply it in the repo </success_criteria>