Requesting Code Review
Overview
Before declaring work complete or merging, run a structured self-review or delegate to the reviewer subagent.
Announce at start: "I'm using the requesting-code-review skill to verify this work."
Pre-Review Checklist
Before requesting review, verify:
- • All tests pass (run them, don't assume)
- • No linting errors
- • Changes match the plan/spec
- • No debug code, commented-out code, or TODOs left behind
- • No unrelated changes mixed in
- • Commit messages are clear and descriptive
- • Edge cases handled
Self-Review Process
- •Read the diff —
git diff main...HEAD(or appropriate base) - •Check each file — Does every change serve the goal?
- •Look for —
- •Hardcoded values that should be config
- •Missing error handling
- •Security issues (injection, auth bypass, secrets)
- •Performance issues (N+1 queries, unbounded loops)
- •Missing tests for new code paths
- •Verify requirements — Re-read spec, check each requirement is met
Delegated Review
Use the reviewer subagent for an independent perspective:
code
/review <scope of changes>
Or via the subagent tool directly:
code
Use reviewer agent to review: <description of what changed>
Severity Levels
| Level | Action | Example |
|---|---|---|
| Critical | Must fix before merge | Security hole, data loss, crash |
| Warning | Should fix | Missing validation, poor error message |
| Suggestion | Consider | Better naming, minor refactor |
Red Flags
- •Skipping review because "it's a small change"
- •Reviewing your own code without a checklist
- •Merging without running the full test suite