diff --git a/docs/users/features/code-review.md b/docs/users/features/code-review.md index 89cfd89f1..83ec76d87 100644 --- a/docs/users/features/code-review.md +++ b/docs/users/features/code-review.md @@ -64,7 +64,7 @@ Clean up (remove worktree + temp files) | Agent 4: Undirected Audit | Business logic, boundary interactions, hidden coupling | | Agent 5: Build & Test | Runs build and test commands, reports failures | -All agents run in parallel. All findings are then verified in a **single batch verification pass** (one agent reviews all findings at once, keeping LLM calls fixed regardless of finding count). After verification, a **reverse audit agent** reviews the diff with knowledge of all confirmed findings to catch issues that every other agent missed. Any reverse audit findings are also batch-verified before inclusion in the final results. +All agents run in parallel. All findings are then verified in a **single batch verification pass** (one agent reviews all findings at once, keeping LLM calls fixed regardless of finding count). After verification, a **reverse audit agent** re-reads the entire diff with knowledge of all confirmed findings to catch issues that every other agent missed. Reverse audit findings skip verification (the agent already has full context) and are included directly as high-confidence results. ## Deterministic Analysis diff --git a/packages/core/src/skills/bundled/review/SKILL.md b/packages/core/src/skills/bundled/review/SKILL.md index 0705f912c..981fc58dd 100644 --- a/packages/core/src/skills/bundled/review/SKILL.md +++ b/packages/core/src/skills/bundled/review/SKILL.md @@ -271,7 +271,7 @@ The reverse audit agent must: 4. Apply the same **Exclusion Criteria** as other agents 5. Return findings in the same structured format (with `Source: [review]`) -Any findings from the reverse audit go through the same **batch verification** as Step 2.5 (a single verification agent reviews all reverse audit findings at once, same confidence levels). Verified findings are merged into the final findings list. +Reverse audit findings are treated as **high confidence** and **skip verification** — the reverse audit agent already has full context (all confirmed findings + entire diff), so its output does not need a second opinion. Findings are merged directly into the final findings list. If the reverse audit finds nothing, that is a good outcome — it means the initial review had strong coverage.