1---
2name: requesting-code-review
3description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements
4---
5 
6# Requesting Code Review
7 
8Dispatch a code reviewer subagent to catch issues before they cascade. The reviewer gets precisely crafted context for evaluation — never your session's history. This keeps the reviewer focused on the work product, not your thought process, and preserves your own context for continued work.
9 
10**Core principle:** Review early, review often.
11 
12## When to Request Review
13 
14**Mandatory:**
15- After each task in subagent-driven development
16- After completing major feature
17- Before merge to main
18 
19**Optional but valuable:**
20- When stuck (fresh perspective)
21- Before refactoring (baseline check)
22- After fixing complex bug
23 
24## How to Request
25 
26**1. Get git SHAs:**
27```bash
28BASE_SHA=$(git rev-parse HEAD~1)  # or origin/main
29HEAD_SHA=$(git rev-parse HEAD)
30```
31 
32**2. Dispatch code reviewer subagent:**
33 
34Use Task tool with `general-purpose` type, fill template at `code-reviewer.md`
35 
36**Placeholders:**
37- `{DESCRIPTION}` - Brief summary of what you built
38- `{PLAN_OR_REQUIREMENTS}` - What it should do
39- `{BASE_SHA}` - Starting commit
40- `{HEAD_SHA}` - Ending commit
41 
42**3. Act on feedback:**
43- Fix Critical issues immediately
44- Fix Important issues before proceeding
45- Note Minor issues for later
46- Push back if reviewer is wrong (with reasoning)
47 
48## Example
49 
50```
51[Just completed Task 2: Add verification function]
52 
53You: Let me request code review before proceeding.
54 
55BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | awk '{print $1}')
56HEAD_SHA=$(git rev-parse HEAD)
57 
58[Dispatch code reviewer subagent]
59  DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types
60  PLAN_OR_REQUIREMENTS: Task 2 from docs/superpowers/plans/deployment-plan.md
61  BASE_SHA: a7981ec
62  HEAD_SHA: 3df7661
63 
64[Subagent returns]:
65  Strengths: Clean architecture, real tests
66  Issues:
67    Important: Missing progress indicators
68    Minor: Magic number (100) for reporting interval
69  Assessment: Ready to proceed
70 
71You: [Fix progress indicators]
72[Continue to Task 3]
73```
74 
75## Integration with Workflows
76 
77**Subagent-Driven Development:**
78- Review after EACH task
79- Catch issues before they compound
80- Fix before moving to next task
81 
82**Executing Plans:**
83- Review after each task or at natural checkpoints
84- Get feedback, apply, continue
85 
86**Ad-Hoc Development:**
87- Review before merge
88- Review when stuck
89 
90## Red Flags
91 
92**Never:**
93- Skip review because "it's simple"
94- Ignore Critical issues
95- Proceed with unfixed Important issues
96- Argue with valid technical feedback
97 
98**If reviewer wrong:**
99- Push back with technical reasoning
100- Show code/tests that prove it works
101- Request clarification
102 
103See template at: requesting-code-review/code-reviewer.md
104