Pimp My IDE / Garage dispatch
Back to garage
September 27, 2026 | code review / human judgment / agent checks

Confusion is a review finding.

An automated reviewer can find bugs, trace inputs, and suggest a patch. It cannot replace the moment when a responsible engineer says, "I do not understand why this change belongs here."

The take. Give detection work to machines. Keep human review focused on intent, missing context, comprehension, and responsibility. A clean bot report does not answer those questions.

Detection is getting good tools.

GitHub says Copilot code review can inspect a full repository, identify issues, suggest fixes, and pass a suggestion to a coding agent. The extra context and tool use run through GitHub Actions. If that path is unavailable, the review still runs with fewer capabilities.[1]

Cursor launched a separate Security Review bot on September 23. Its announcement says the bot follows input into SQL, command, and template sinks. It also checks authentication, authorization, secrets, redirects, deserialization, and dependency changes. Cursor keeps style and code quality in another bot.[2]

That division is useful. A machine can apply the same detection routine to every pull request. Teams should use it. The mistake is treating that routine as the whole review.

A person can fail to understand the change.

John Allspaw argues that a reviewer's confusion carries information. The code may be too complex. The abstraction may be wrong. The intent may be missing. A system that can always produce an explanation does not reproduce the friction felt by the person who must maintain the code later.[3]

If an experienced reviewer cannot explain the change, the change has failed a maintenance test.

Google's review guide makes the same pressure concrete. It asks whether the change belongs in the codebase, whether now is the right time, whether the design fits the system, and whether every line is understandable. It tells reviewers to stop and ask for clarification when code is too hard to read.[4]

The missing part may live outside the repository.

A repository can hold code, tests, design notes, and recent incidents. It rarely holds every current agreement. A downstream team may be retiring an interface. Legal may have changed a logging rule. The service may have failed in a way that no test fixture records yet. A reviewer can connect the diff to that live context.

Automation can search the context it receives. It cannot discover an agreement that nobody wrote down. This is not a reason to keep context informal. It is a reason to capture the missing fact in the review, then move it into the repository or operating record.

Use the bot report as an input.

Run automated review early. Let it handle repeatable checks and candidate defects. Then ask a human to judge the change's purpose, shape, omissions, and owner. The human should be allowed to ask a question without first proving a bug.

The brake below turns that pass into a copyable question map. Selecting every lane means four judgments have been recorded. It does not mean the code is correct, the tests passed, or the change can merge.

Interactive makeover / review friction

Review confusion brake

Traditional purpose replaced: scan the diff, clear the comments, and approve. Better version: set one explicit judgment for each human review lane, route every question or hold into a shared brake line, and copy the handoff.

Set four review lanes

Each lane is independent. Use Clear, Ask, or Hold only after reading. Leave Unread when that judgment has not happened.

01 Intent
02 Comprehension
03 Missing context
04 Ownership
0/4Four review lanes are unread. No merge judgment recorded.

Teaching display. Lane selections record reviewer judgments. They do not run tests or inspect the pull request.

Human review handoff0 JUDGMENTS SELECTED

Copy the question map

The prompts name what to discuss. Add links, examples, and a responsible reviewer before merge.

What completion means. Four lane judgments are selected. Automated findings, test results, supporting context, named responsibility, and merge approval remain separate evidence.

Sources and limits

Open the source log
  1. GitHub Docs, "About GitHub Copilot code review", read September 27, 2026. It documents repository context gathering, suggested fixes, coding-agent handoff, and the reduced mode used when supporting Actions jobs fail.
  2. Cursor changelog, "Rollouts and Security Review", published September 23 and read September 27, 2026. The listed checks and product boundaries are Cursor's claims. This page did not test the product.
  3. John Allspaw, "There is more to code review than automatable detection", published August 24 and read September 27, 2026. It argues that confusion, skepticism, missing context, joint understanding, and accountability are part of peer review.
  4. Google Engineering Practices, "What to look for in a code review", read September 27, 2026. It asks reviewers to judge design, user value, complexity, tests, context, and understandability.
  5. Hacker News discussion 49857281, verified through the official HN API on September 27, 2026. It surfaced Allspaw's article. Votes and comments show attention, not correctness.

Source boundary. Product capabilities come from vendor documentation and announcements. The human-review argument comes from Allspaw and Google's published review guidance. The confusion brake is an editorial tool. This page did not compare reviewer defect rates or run either review product.