obra logo
#128 by installsCoding & architectureobra/superpowers

systematic-debugging

Hypothesis-driven debugging loop: observe, hypothesize, test, verify

Installs
308K
all time
This week
9.4K
installs
Repo stars
295.3K
GitHub
First seen
Jan 19, 2026
on skills.sh
Install
npx skills add https://github.com/obra/superpowers --skill systematic-debugging
Works with Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI and other agents that read SKILL.md.
What it does

Structured debugging methodology that mandates root cause investigation before attempting any fixes. Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

  • Four-phase process: root cause investigation, pattern analysis, hypothesis testing, and implementation with mandatory test cases
  • Requires completing Phase 1 (evidence gathering, error analysis, data flow tracing) before proposing any fixes; blocks symptom-based patching
  • Includes diagnostic instrumentation guidance for multi-component systems and backward call-stack tracing techniques to isolate failure points