superpowers-receiving-code-review
Skill101 starsChanged 30 days agoMITView on GitHub
Got review feedback? Load BEFORE changing anything — verify each point, push back if wrong.
1 other project uses a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- EvovexAI/EvoFlowedited, first seen Oct 8, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 1
- EvovexAI/EvoFlow★ 61245% same
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository12 other files it gives its agents.
- AGENTS.mdAGENTS.md
- superpowers-brainstormingSkill
- superpowers-diagnosing-superpowersSkill
- superpowers-executing-plansSkill
- superpowers-finishing-a-development-branchSkill
- superpowers-sync-upstreamSkill
- superpowers-systematic-debuggingSkill
- superpowers-test-driven-developmentSkill
- superpowers-using-git-worktreesSkill
- superpowers-verification-before-completionSkill
- superpowers-writing-plansSkill
- superpowers-writing-skillsSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Core principle: Verify before implementing.
- Distinctive: line 59
Still ask: if scope unclear
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Code Review Reception
Overview
Code review = technical evaluation. Not emotional performance.
Core principle: Verify before implementing. Ask before assuming. Technical correctness beats social comfort.
The Response Pattern
WHEN receiving code review feedback:
1. READ: Full feedback, no reacting
2. UNDERSTAND: Restate requirement in own words (or ask)
3. VERIFY: Check against codebase reality
4. EVALUATE: Technically sound for THIS codebase?
5. RESPOND: Technical ack or reasoned pushback
6. IMPLEMENT: One item at a time, test eachForbidden Responses
NEVER:
- "You're absolutely right!" (performative agreement)
- "Great point!" / "Excellent feedback!" (performative)
- "Let me implement that now" (before verification)
INSTEAD: restate technical requirement; ask clarifying questions; push back with technical reasoning if wrong; or just start working (actions > words).
Handling Unclear Feedback
IF any item unclear:
STOP - implement nothing yet
ASK for clarification on unclear items
WHY: Items may be related. Partial understanding = wrong implementation.Example:
Partner: "Fix 1-6"
You understand 1,2,3,6. Unclear on 4,5.
❌ WRONG: Implement 1,2,3,6 now, ask 4,5 later
✅ RIGHT: "Understand items 1,2,3,6. Need clarification on 4 and 5 before proceeding."Source-Specific Handling
From your human partner
- Trusted — implement after understanding
- Still ask if scope unclear
- No performative agreement — skip to action or technical ack
From External Reviewers (or a reviewer subagent)
BEFORE implementing:
1. Technically correct for THIS codebase?
2. Breaks existing functionality?
3. Reason for the current implementation?
4. Works on all platforms/versions?
5. Does the reviewer understand full context?
IF suggestion seems wrong: push back with technical reasoning
IF can't easily verify: "I can't verify this without [X]. Should I [investigate/ask/proceed]?"
IF conflicts with your human partner's prior decisions: stop and discuss firstRule: External feedback — stay skeptical. Check carefully.
YAGNI Check for "Professional" Features
IF reviewer suggests "implementing properly":
grep codebase for actual usage
IF unused: "Endpoint isn't called. Remove it (YAGNI)?"
IF used: implement properlyImplementation Order
FOR multi-item feedback:
1. Clarify anything unclear FIRST
2. Then implement in order:
- Blocking issues (breaks, security)
- Simple fixes (typos, imports)
- Complex fixes (refactoring, logic)
3. Test each fix individually
4. Verify no regressionsWhen To Push Back
Push back when suggestion: breaks existing functionality; comes from reviewer lacking full context; violates YAGNI (unused feature); is technically incorrect for this stack; ignores legacy/compatibility reasons; conflicts with your human partner's architectural decisions.
How: technical reasoning, not defensiveness; ask specific questions; reference working tests/code; involve your human partner if architectural.
Acknowledging Correct Feedback
✅ "Fixed. [what changed]"
✅ "Good catch - [specific issue]. Fixed in [location]."
✅ [Just fix it; show it in code]
❌ "You're absolutely right!" ❌ "Great point!" ❌ "Thanks for catching that!"
❌ ANY gratitude expressionWhy no thanks: actions speak. Just fix it — code shows you heard. Catch yourself writing "Thanks"? Delete it. State the fix.
Gracefully Correcting Your Pushback
Pushed back, but wrong:
✅ "You were right - checked [X], it does [Y]. Implementing now."
✅ "Verified, you're correct. My understanding was wrong because [reason]. Fixing."
❌ Long apology ❌ Defending why you pushed back ❌ Over-explainingState correction factually. Move on.
Common Mistakes
| Mistake | Fix |
| Performative agreement | State requirement or just act |
| Blind implementation | Verify against codebase first |
| Batch without testing | One at a time, test each |
| Assuming reviewer is right | Check if it breaks things |
| Avoiding pushback | Technical correctness > comfort |
| Partial implementation | Clarify all items first |
| Can't verify, proceed anyway | State limitation, ask for direction |
GitHub Thread Replies
Replying to inline GitHub review comments? Reply in the thread (gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies), not as a top-level PR comment.
The Bottom Line
External feedback = suggestions to evaluate, not orders to follow.
Evaluate each item against the actual code before acting. Push back on what's wrong. No performative agreement. Technical rigor always.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

