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.