Home
cd ../playbooks
Developer ToolsIntermediate

PR Reviewer

Senior engineer PR review system - structured feedback on correctness, security, tests, and maintainability with actionable diffs.

5 minutes
By andreolfSource
#code-review#pull-request#engineering#testing#security

Your PR has been waiting for review for two days because the senior engineer is in meetings. When feedback finally comes, it's 'LGTM' on the easy PRs and silence on the complex ones. You need a consistent, thorough first pass that catches real issues — not a rubber stamp.

Who it's for: developers wanting instant thorough feedback on their PRs, engineering teams with review bottlenecks, solo developers without a senior engineer to review their code, tech leads wanting consistent review quality across the team, open-source maintainers handling high PR volumes

Example

"Review my PR before I ask the team" → Structured review covering correctness (2 logic issues), security (1 SQL injection risk), test coverage (3 untested edge cases), maintainability (4 suggestions), and actionable diffs for each finding

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

Or install from your terminal:
npx ccplaybooks add pr-reviewer
SYSTEM
You are a senior engineer doing PR reviews. You are strict, helpful, and precise.

CONTEXT
Repo: {{repo}}
PR title: {{title}}
Risk tolerance: {{risk}}
Date: {{date}} (UTC {{time_utc}})

INPUT
{{input}}

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

Acts as a strict, precise senior engineer reviewing your pull requests. Provides structured feedback organized by risk level, with actionable fixes and a test plan covering unit, integration, and edge cases.


Quick Start

Step 1: Download the Template

Click Download above to get the CLAUDE.md file.

Step 2: Provide PR Context

Fill in the repo name, PR title, and risk tolerance level.

Step 3: Run the Review

claude

Say: "Review this PR" and paste the diff or PR link.


Review Focus Areas

Area What's Checked
Correctness Logic errors, edge cases, off-by-ones
Security Injection, auth issues, data exposure
Tests Coverage gaps, missing edge cases
Maintainability Readability, naming, complexity

Example Output

## Summary
- Adds rate limiting middleware to API endpoints
- Refactors auth token validation into shared util
- Missing error handling for Redis connection failures

## High Risk Issues
- Issue: Redis connection failure crashes server
  - Why: No try/catch around Redis calls in rate limiter
  - Fix: Add fallback to allow requests when Redis is down

## Medium Risk Issues
- Issue: Rate limit key doesn't include API version
  - Why: v1 and v2 share limits, could block v2 users
  - Fix: Include version prefix in Redis key

## Test Plan
- Unit: Rate limiter returns 429 after threshold
- Integration: Middleware integrates with Express pipeline
- Edge cases: Redis down, concurrent requests, key expiry

Tips

  • Set risk tolerance: "Low" for production-critical code, "High" for internal tools
  • Provide full diff: More context = better review
  • Iterate on findings: Ask follow-up questions about specific issues
  • Pair with CI: Run before merge to catch issues early

Commands

"Review this PR for security issues"
"Focus on the test coverage gaps"
"What are the high-risk changes?"
"Suggest a test plan for this PR"
"Give me actionable diffs for the fixes"

$Related Playbooks

Developer Tools

Release Notes Generator

Generate release notes, changelogs, and announcement copy from diffs and PR summaries - with upgrade notes and test checklist.

5 minutes
Beginner
Developer Tools

REA: Reverse Engineer Anything

Investigate how a shipped app, binary, or website works, with evidence for every conclusion, using the REA MCP server and a Claude workflow for it

15 minutes
Advanced
Developer Tools

React Native Video (v6 & v7)

Give correct react-native-video guidance by detecting the installed major version first — v6's imperative <Video> component and v7's completely different useVideoPlayer/VideoView player-object model share a name but no API, and mixing them up is the single most common mistake when helping with this library.

5 minutes
Intermediate
Developer Tools

React Three Fiber Animation Reference

Animate React Three Fiber scenes correctly — useFrame fundamentals with render priority, full GLTF animation control via useAnimations (playback, crossfade, event listeners, speed-based blending between Idle/Walk/Run), @react-spring/three physics animations with gesture and chain integration, and the five performance rules that keep per-frame updates from triggering React re-renders.

10 minutes
Intermediate
Developer Tools

Ralph Wiggum Autonomous Loop

Self-referential development loop that keeps Claude iterating on the same task until it hits a completion promise or an iteration cap — a Stop hook that blocks exit and re-feeds the same prompt.

5 minutes
Advanced
Developer Tools

QA Expert

Establish a comprehensive QA process — test strategies, Google-standard test cases, P0–P4 bug tracking, quality metrics, OWASP security testing, and 90% coverage targets.

20 minutes
Advanced
Developer Tools

API & Integration Documentation

Generate comprehensive API documentation with endpoint references, authentication guides, code examples, and integration tutorials.

10 minutes
Intermediate
Developer Tools

Code Review Summary & Documentation

Generate structured code review summaries with findings categorization, pattern analysis, and team improvement recommendations.

5 minutes
Beginner
Developer Tools

Scientific Aeon

This skill should be used for time series machine learning tasks including classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search. Use when working with temporal data, sequential patterns, or ti...

10 minutes
Intermediate
Developer Tools

Scientific Astropy

Comprehensive Python library for astronomy and astrophysics. This skill should be used when working with astronomical data including celestial coordinates, physical units, FITS files, cosmological calculations, time systems, tables, world coordina...

10 minutes
Intermediate
Developer Tools

Scientific Cirq

Google quantum computing framework. Use when targeting Google Quantum AI hardware, designing noise-aware circuits, or running quantum characterization experiments. Best for Google hardware, noise modeling, and low-level circuit design. For IBM har...

15 minutes
Advanced
Developer Tools

Scientific Fluidsim

Framework for computational fluid dynamics simulations using Python. Use when running fluid dynamics simulations including Navier-Stokes equations (2D/3D), shallow water equations, stratified flows, or when analyzing turbulence, vortex dynamics, o...

15 minutes
Advanced

Browse all Developer Tools playbooks →