CC-301e · Module 2

AI-Assisted PR Review

3 min read

Reviewing someone else's PR with Claude Code is a two-phase process. Phase one: load context. Check out the PR branch, let Claude read the diff, and ask for an initial assessment. "Review the diff on this branch. Check for type safety issues, missing error handling, and any patterns that violate our CLAUDE.md conventions." Claude produces a structured review that covers the mechanical checks — exactly the tedious work you want to offload.

Phase two: focus your human review on what Claude cannot evaluate. Business logic correctness. Architectural fit. Performance implications. User experience impact. The combination of AI mechanical review and human judgment review is more thorough than either alone and takes less total time than a fully manual review.

Do This

  • Use Claude for mechanical checks: types, error handling, naming, patterns
  • Focus your human review on architecture, logic, and business rules
  • Have Claude check the diff against CLAUDE.md conventions
  • Ask Claude to verify test coverage for changed code paths

Avoid This

  • Rely solely on Claude for architectural review decisions
  • Skip human review because Claude said the code looks fine
  • Have Claude review without loading the project CLAUDE.md context
  • Ask Claude to approve or reject the PR — that is a human decision