systematic-debugging

Enforce a four-phase debugging methodology to identify root causes before implementing solutions.

1|Updated Nov 17, 2025
One-click install
npx skills add https://github.com/nimeshgurung/artifact-hub-collections --skill systematic-debugging-nimeshgurung
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/nimeshgurung/artifact-hub-collections/tree/main/skills/raw/obra/superpowers/skills/systematic-debugging
Command: npx skills add https://github.com/nimeshgurung/artifact-hub-collections --skill systematic-debugging-nimeshgurung

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill prevents wasted time and new bugs caused by quick fixes and symptom-based solutions, ensuring that the true root cause of any issue is identified and addressed systematically.

Core Features & Use Cases

  • Four-Phase Framework: Guides users through Investigation, Pattern Analysis, Hypothesis Testing, and Implementation.
  • Root Cause Mandate: Emphasizes finding the underlying issue before applying any solution.
  • Pressure Resistance: Includes rules and language designed to prevent shortcuts under time pressure.
  • Use Case: When a critical bug appears in production, this Skill ensures you follow a rigorous process to find the actual source of the problem, rather than applying a temporary patch that might fail later or introduce new issues.

Quick Start

Use the systematic debugging skill to investigate any bug or unexpected behavior before proposing fixes.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of a bug instead of just fixing the symptoms?

To find the root cause of a bug, you need a structured debugging methodology that enforces strict investigation, pattern analysis, and hypothesis testing before implementing any solution. This prevents symptom-fixing and ensures robust results.

What is the best way to troubleshoot critical production failures without introducing new issues?

The best way to troubleshoot critical production failures is to apply a four-phase debugging framework: Investigation, Pattern Analysis, Hypothesis Testing, and Implementation. This pressure-resistant process prevents quick patches that might fail later or introduce new bugs.

Why does quick fixing often lead to recurring software problems and test failures?

Quick fixing leads to recurring software problems because it addresses symptoms rather than the underlying root cause. Without a systematic investigation and hypothesis testing phase, temporary patches often fail under different conditions or create new issues.

Can I use a systematic debugging approach for performance degradation and test failures?

Yes, you can use a systematic debugging approach for performance degradation and test failures. The methodology applies to all technical problems by enforcing pattern analysis and hypothesis verification before any implementation begins.

How do I investigate unexpected software behavior step by step?

To investigate unexpected software behavior step by step, follow a four-phase framework: gather information during Investigation, perform Pattern Analysis, conduct Hypothesis Testing, and finally verify the fix during Implementation to ensure robust solutions.

When should I avoid symptom-based troubleshooting for complex bugs?

You should avoid symptom-based troubleshooting for complex bugs whenever you face critical issues or time pressure. A systematic debugging methodology uses strict rules to prevent shortcuts, ensuring you identify the true root cause before applying fixes.