Document Review

Workflow

1. Read target document — Read the ENTIRE file at $ARGUMENTS in one pass. Note total line count.
2. Read referenced documents — Scan for mentions of PRDs, design docs, specs, or style guides. Read each one for context. If none found, proceed without.
3. Choose review mode — Based on document size:
   • ≤300 lines → Single-agent mode (Step 4a)
   • >300 lines → Parallel multi-agent mode (Step 4b)

4a. Single-Agent Review

Spawn ONE review sub-agent via Task tool (subagent_type: "general-purpose"). Pass full document content and all referenced context. Instruct the sub-agent to:

• Check correctness, structure, completeness, clarity, and grammar
• Categorize each issue as Critical / Important / Minor
• Return a markdown table: Severity | Line | Category | Issue | Fix
• Sort by severity (Critical first), then line number

4b. Parallel Multi-Agent Review