{"enrichment":{"faq":[{"a":"Systematic Debugging guides you through a four-phase approach: first investigate by gathering error messages and evidence, then analyze patterns by comparing working versus broken code paths. Form a hypothesis about what's wrong, test it with minimal instrumentation, and only after confirming the root cause implement your fix. This prevents symptom-level repairs that mask deeper issues.","q":"How do I find the root cause of a bug before fixing it?"},{"a":"Systematic Debugging emphasizes tracing data flow through your multi-component system to locate where failures occur. Instrument each layer to see what's actually happening rather than guessing. If three different fixes fail, stop and question whether an architectural problem exists instead of continuing to patch symptoms.","q":"What is the systematic approach to troubleshooting production issues?"},{"a":"Systematic Debugging teaches you to investigate the root cause through error analysis and evidence gathering before attempting any fixes. Compare the failing test's behavior against passing tests to identify patterns. Form a hypothesis about the difference, verify it with targeted testing, then implement your fix only after confirming the actual root cause.","q":"How do I debug test failures systematically?"},{"a":"Systematic Debugging applies the scientific method to debugging: gather evidence from logs and errors, analyze patterns by examining working and broken code side-by-side, form testable hypotheses, and verify them with minimal instrumentation before fixing. This structured workflow prevents wasted time on incorrect assumptions and surface-level repairs.","q":"How can I trace bugs in code using a structured debugging approach?"},{"a":"Systematic Debugging recommends stopping after three failed fix attempts to reassess. Rather than continuing to patch symptoms, question whether an architectural problem exists. Trace data flow across components to see if the issue lies in system design rather than isolated code. This prevents endless cycles of ineffective fixes.","q":"What should I do when multiple debugging attempts fail?"},{"a":"Systematic Debugging's disciplined four-phase process\u2014investigate, analyze, hypothesize, test\u2014actually saves time by eliminating guesswork. By finding the root cause first rather than trying random fixes, you avoid wasted effort. The framework also tells you when to stop patching and escalate to architectural review, preventing prolonged firefighting.","q":"How does Systematic Debugging help with debugging under time pressure?"}],"shadow_tags":["root-cause-analysis","investigative-process","evidence-gathering","hypothesis-testing","troubleshooting-methodology","data-flow-tracing","multi-layer-diagnostics","architecture-validation","test-driven-repair","symptom-vs-cause"],"summary_rewrite":"Systematic Debugging enforces a disciplined four-phase approach to troubleshooting: investigate the root cause through error analysis and evidence gathering, analyze patterns by comparing working and broken code, form and test hypotheses scientifically, then implement fixes. The skill emphasizes that symptom-level repairs fail\u2014you must trace data flow, instrument multi-component systems, and stop after three failed attempts to question architectural soundness."},"files":[{"bytes":9465,"path":"skills/systematic-debugging/SKILL.md","sha256":"808fc5717aa88ad65efff312b11c186294d3e6ee301afb584e2f86599b137787","url":"https://skillfed.io/files/obra/superpowers/systematic-debugging/4afeb1dc/SKILL.md"}],"id":"obra/superpowers/systematic-debugging","links":{"html":"https://skillfed.io/obra/superpowers/systematic-debugging","md":"https://skillfed.io/obra/superpowers/systematic-debugging.md","repo":"https://github.com/obra/superpowers"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":23414,"language":"Shell","last_updated":"2026-07-24","license":"MIT","name":"systematic-debugging","publisher":"obra","stars":262225},"relations":{"categories":["software-development","quality-assurance","devops"],"similar":[{"id":"getcrew44/crew44/systematic-debugging"},{"id":"rpamis/comet/systematic-debugging"},{"id":"beita6969/ScienceClaw/systematic-debugging"},{"id":"zernie/vigiles/systematic-debugging"},{"id":"xintaofei/codeg/systematic-debugging"},{"id":"guanyang/open-agent-hub/systematic-debugging"},{"id":"Delphine-L/claude_global/systematic-debugging"},{"id":"ratacat/claude-skills/systematic-debugging"},{"id":"ArcReel/ArcReel/systematic-debugging"},{"id":"julianromli/ai-skills/systematic-debugging"}]},"slug":{"owner":"obra","repo":"superpowers","skill":"systematic-debugging"},"version":"4afeb1dc"}