systematic-debugging

Diagnoses bugs via a four-phase, evidence-based, root-cause-driven process before implementing fixes.

Updated May 21, 2026
One-click install
npx skills add https://github.com/jaehun0630/cline-superpowers --skill systematic-debugging-jaehun0630
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/jaehun0630/cline-superpowers/tree/main/packages/skills/systematic-debugging
Command: npx skills add https://github.com/jaehun0630/cline-superpowers --skill systematic-debugging-jaehun0630

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined, evidence-based approach to diagnosing bugs, preventing symptom fixes, and speeding reliable resolution.

Core Features & Use Cases

  • Four-phase workflow: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis & Testing, Phase 4 Implementation, all mandatory before fixes.
  • Anti-patterns and defense-in-depth guidance to resist rushing or shortcuts.
  • Supports integration with related techniques like root-cause tracing to improve traceability and long-term resilience.

Quick Start

Load this skill and follow Phase 1 through Phase 4 to systematically diagnose and resolve bugs.

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 symptom?

Root-cause debugging requires an evidence-based investigation process to prevent symptom fixes. You must complete four mandatory phases—Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation—before applying any code fixes.

What is the best way to debug production incidents without guesswork?

Debugging production incidents without guesswork involves following a systematic, four-phase workflow guided by evidence. This process enforces defense-in-depth practices and traceability to ensure reliable resolution of complex software issues.

Why do I need to complete multiple phases before implementing a bug fix?

Completing multiple phases before implementing a bug fix prevents rushed shortcuts and symptom fixes. The mandatory phases ensure you investigate root causes, analyze patterns, and test hypotheses first, leading to a reliable resolution.

How do I systematically diagnose test failures during software development?

To systematically diagnose test failures, apply a root-cause driven debugging process. This requires moving through evidence-based investigation phases, including root cause identification and hypothesis testing, before modifying code.

Can this systematic debugging process be used for performance issues?

Yes, this systematic debugging process applies to performance issues alongside test failures and production incidents. It guides engineers through evidence-based investigation phases to find and resolve the root cause reliably.

Does this debugging workflow integrate with root-cause tracing techniques?

Yes, the debugging workflow supports integration with root-cause tracing techniques to improve traceability. This integration enhances long-term resilience and applies defense-in-depth practices against rushing to implement fixes.