Loading...
Loading...
Fix bugs systematically instead of guessing. Use when features break, users report errors, or tests fail. Covers reproducing bugs, gathering diagnostic info, and working with AI tools to fix issues efficiently for non-technical founders.
npx skill4agent add whawkinsiv/claude-code-superpowers debugDebug Process:
- [ ] Reproduce bug consistently
- [ ] Capture what's happening (screenshots, errors)
- [ ] Check what changed recently
- [ ] Gather diagnostic info
- [ ] Give info to AI to diagnose
- [ ] AI proposes fix
- [ ] Test fix works
- [ ] Verify didn't break anything elseCan you reproduce it?
- [ ] Exact steps to trigger bug
- [ ] Happens every time
- [ ] Happens on specific browser/device
- [ ] Happens with specific data
If can't reproduce:
- Ask user for exact steps
- Try different browser/device
- Try with different data
- Check if intermittent (timing issue)Bug: [description]
Steps to reproduce:
1. [Step]
2. [Step]
3. [Bug happens]
Happens: [Always / Sometimes / Once]
Browser: [Chrome 120 on Mac]
Screenshot: [attach]I see this error in console:
[paste error message]
When it happens:
[what you were doing]
Please:
1. Explain what this means
2. Identify the cause
3. Fix the issueAPI call failing:
URL: /api/endpoint
Status: 500 Internal Server Error
Response: [paste error response]
This happens when: [action]Visual bug: [description]
Expected: [screenshot or description]
Actual: [screenshot]
Device: [iPhone 14, Chrome on Mac, etc]This worked yesterday, broke today.
Changes made today:
- [Change 1]
- [Change 2]
Which could cause: [the bug]?Button does nothing when clicked.
Button: [which button]
Expected: [what should happen]
Console errors: [paste any errors]Page won't load: /page/url
Browser shows: [blank / error / loading forever]
Console errors: [paste]
Network errors: [paste]Showing wrong data.
Expected: [User A's profile]
Showing: [User B's profile]
API response: [paste from Network tab]Form won't submit.
Form: [which form]
Filled: [what data entered]
Validation errors: [any visible]
Console errors: [paste]Before asking AI to fix, provide:
- Exact steps to reproduce
- Expected vs actual behavior
- Screenshots/error messages
- Browser and device
- What changed recently (if known)[Paste all info above]
Before proposing fixes:
1. What do you think is wrong?
2. Why is it happening?
3. What needs to change?
Explain in plain English first.Okay, now please fix it.
After fixing:
- Explain what you changed
- How to test the fix
- What to watch out forTest the fix:
- [ ] Original bug is gone
- [ ] Tested same steps, works now
- [ ] Related features still work
- [ ] No new console errorsTried 2 fixes, both didn't work.
Original bug: [description]
Fix 1: [what we tried] - didn't work
Fix 2: [what we tried] - still broken
Questions:
- Are we fixing the wrong thing?
- Is there a better approach?
- Should we start over?Bug is intermittent.
Works: [X] out of 10 times
Fails: [Y] out of 10 times
Pattern noticed:
- Fails more often when [condition]
- Never fails when [condition]
Please add logging to capture when it fails.Production bug blocking users.
Bug: [description]
Impact: [how many users affected]
Need quick fix:
- Simplest solution that works
- Don't optimize, just unblock users
- Can improve laterProduction bug reported by user.
Bug: [description]
Impact: [minor / major]
Can work around: [yes / no]
Reproduce in development:
[steps]
Then fix and test before deploying.| Mistake | Fix |
|---|---|
| Trying fixes without info | Gather diagnostic info first |
| "It doesn't work" | Be specific: what doesn't work? |
| Not reproducing first | Find consistent steps to trigger bug |
| Random fixes | Diagnose root cause first |
| Ignoring console errors | Always check console |
| Not testing after fix | Verify fix works, didn't break other things |
Bug is fixed.
How could we have prevented this?
- Better validation?
- Better error handling?
- Testing we should add?Quick Debug:
- [ ] Can I reproduce it?
- [ ] Any console errors?
- [ ] Any network errors?
- [ ] What changed recently?
- [ ] Screenshot the issue
- [ ] Gather all info
- [ ] Give to AI with context
- [ ] Test AI's fix