claude-pr-deep-review

End-to-end PR/branch review skill for Claude Code. Combines code-review, security-review, simplify, real test runs, and spec cross-check in a single pass with evidence-backed reporting.

What It Does

10-phase review process:

1. Setup (worktree or checkout)
2. Inspect diff (stat, log, full diff, read changed files)
3. Codebase pattern comparison (adjacent siblings, convention divergence)
4. Code review (5-angle: line-by-line, removed-behavior, cross-file, language-pitfall, wrapper correctness)
5. Security review (AuthN/AuthZ bypass, SQL injection, info leakage)
6. Simplify (dead code, test divergence, trailing whitespace)
7. Run tests (unit, integration, typecheck, lint)
8. Test coverage gap analysis (happy path, 401, 403, cross-tenant, edge cases)
9. Spec cross-check (requirement table with evidence)
10. Final report (structured markdown with evidence for every claim)

Installation

npx (one command)

npx claude-pr-deep-review

curl

curl -fsSL https://raw.githubusercontent.com/danolez1/claude-pr-deep-review/main/install.sh | bash

Clone

git clone https://github.com/danolez1/claude-pr-deep-review.git
cd claude-pr-deep-review && ./install.sh

Usage

In any Claude Code session:

/pr-deep-review feature/my-branch

Arguments (free-form text):

• branch (required): PR branch name or PR number
• base (optional): base branch (default: develop, then main)
• task details (optional): acceptance criteria from ticket
• reference doc (optional): absolute path to spec file for cross-check

Iron Rules

• No completion claim without evidence (command + exit code + counts)
• Pre-existing failures must be proven (re-run on base)
• Regen before test (if generated files exist)
• Adjacency proves convention (quote sibling file:line)
• Never trust agent summaries (read actual output)

License

MIT