superpowers-receiving-code-review
Use when receiving code review feedback — respond with technical rigor using a 6-step pattern: read without reacting, understand by restating, verify against actual codebase reality, evaluate technica
Files1
View on GitHubSKILL.mdskills/receiving-code-review/SKILL.md
GitHubReceiving Code Review
Core principle: "Verify before implementing. Ask before assuming. Technical correctness over social comfort."
The 6-Step Response Pattern
- Read — absorb complete feedback without reacting
- Understand — restate in own words or ask for clarification
- Verify — check against actual codebase reality
- Evaluate — is it technically sound for this codebase?
- Respond — technical acknowledgment or reasoned pushback
- Implement — one item at a time, test each
Handling Unclear Feedback
Stop completely if any item is unclear. Items may be related — partial understanding leads to wrong implementation.
If you understand items 1,2,3 but not 4,5 — state exactly that and ask for clarification before proceeding on anything.
Source-Specific Handling
From your human partner: trusted after understanding; still ask if scope unclear; skip performative agreement; go straight to action.
From external reviewers: evaluate suggestions, don't follow orders. Before implementing:
- Check if technically correct for this codebase
- Check if it breaks existing functionality
- Check the reason for the current implementation
- Check if it works on all platforms/versions
- Check if the reviewer understands the full context
If suggestion seems wrong: push back with technical reasoning.
YAGNI Check
When a reviewer suggests adding features: grep the codebase for actual usage. If unused, propose removing it instead.
Implementation Order for Multi-Item Feedback
- Clarify unclear items first
- Then implement: blocking issues → simple fixes → complex fixes
- Test each fix individually
- Verify no regressions
When to Push Back
- Suggestion breaks existing functionality
- Reviewer lacks full context
- Violates YAGNI
- Technically incorrect for this stack
- Conflicts with architectural decisions
Use technical reasoning (not defensiveness), reference working tests/code.
Acknowledging Correct Feedback
- ✅ "Fixed. [Brief description]"
- ✅ "Good catch — [specific issue]. Fixed in [location]."
- ❌ Any gratitude expression ("Thanks", "You're right", etc.)
Actions speak louder than words.
Gracefully Correcting Wrong Pushback
State the correction factually and move on:
- "You were right — I checked [X] and it does [Y]. Implementing now."
- No long apology, no defending why you pushed back.
GitHub Thread Replies
Reply in the inline comment thread, not as a top-level PR comment.
Forbidden Responses
Avoid performative agreement:
- "You're absolutely right!"
- "Great point!" / "Excellent feedback!"
- "Let me implement that now" (before verification)