systematic-debugging

Diagnose bugs using a four-phase root-cause framework before proposing fixes.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/bbohhu-prog/waxs --skill systematic-debugging-bbohhu-prog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/bbohhu-prog/waxs/tree/main/.claude/skills/superpowers/systematic-debugging
Command: npx skills add https://github.com/bbohhu-prog/waxs --skill systematic-debugging-bbohhu-prog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a disciplined, repeatable framework to uncover root causes of bugs, failures, and flaky behavior before implementing fixes, reducing firefighting and rework.

Core Features & Use Cases

  • A four-phase process (Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, Implementation) with explicit rules, including mandatory Phase 1 before fixes and STOP-and-reanalyze guidance.
  • Thorough defense-in-depth approach and data-flow tracing to prevent regressions and ensure robust fixes across entry, logic, environment, and debugging instrumentation.
  • Works for production incidents, test failures, flaky tests, performance issues, and integration problems, offering structured guidance and validation throughout the lifecycle.

Quick Start

Begin with Phase 1 Root Cause Investigation, then complete Phases 2–4 and verify the root cause before applying any fix.

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 flaky test or production incident before fixing it?

Debugging complex multi-component failures systematically requires a structured four-phase approach: investigate root causes first, analyze patterns, form testable hypotheses, and implement fixes only after verifying the root cause through defensive practices and data-flow tracing.

What is the best way to debug production incidents without causing regressions?

The best way to debug production incidents without regressions is applying defense-in-depth patterns and data-flow tracing during the fix implementation phase, creating failing tests to validate the root cause before deploying changes across logic and environment layers.

How do I systematically debug a complex multi-component system failure?

Systematically debug complex multi-component system failures by following a strict phase-based framework: start with root cause investigation, proceed to pattern analysis, validate through hypothesis testing, and finish with implementation using defensive practices and debugging instrumentation.

Can I skip root cause investigation and jump straight to fixing bugs?

You cannot skip root cause investigation, as the systematic debugging framework enforces an explicit rule requiring mandatory Phase 1 completion before proposing fixes, including STOP-and-reanalyze guidance if patterns shift during hypothesis testing.

When do I need a systematic debugging approach for test failures?

You need a systematic debugging approach for test failures, flaky tests, performance issues, and integration problems when you want to reduce firefighting and rework by uncovering exact root causes through structured hypothesis testing rather than applying immediate patches.