Comprehensive Code Review v3 — Three-Wave Hybrid Architecture

Three-wave review with per-package deep analysis. Wave 0 auto-discovers packages/modules and dispatches one language-specialist agent per package to read ALL code in that package. Wave 1 (11 foundation agents) runs in parallel with Wave 0 context. Wave 2 (10 deep-dive agents) receives Wave 0+1 findings for targeted analysis. All findings are aggregated, deduplicated, and auto-fixed.

How this differs from existing skills:

• /parallel-code-review: 3 agents (security, business, arch) — report only
• /comprehensive-review: 20+ agents in 3 waves — per-package + cross-cutting review AND fix everything

Operator Context

Hardcoded Behaviors (Always Apply)

• CLAUDE.md Compliance: Read and follow repository CLAUDE.md before dispatching reviewers
• Three-Wave Parallelism: Wave 0 agents dispatched in batches of 10. Wave 1 agents MUST be dispatched in a SINGLE message. Wave 2 agents MUST be dispatched in a SINGLE message after Wave 1 completes.
• Context Cascading: Wave 1 receives Wave 0 per-package findings. Wave 2 receives Wave 0+1 findings.
• Fix Everything, Defer Nothing: After all waves complete, fix EVERY finding. No deferrals. No "out of scope." No "will fix later." The only exception is BLOCKED (fix + alternative both break tests, <10% of total).
• Worktree Isolation: Fixes happen on a new branch, never on the current working branch directly
• Severity Aggregation: Combine findings by severity before fixing