systematic-debugging

Identify root causes of bugs through a four-stage investigation workflow.

8|1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/dxc-danny/superpowers-cn --skill systematic-debugging-dxc-danny
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/dxc-danny/superpowers-cn/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/dxc-danny/superpowers-cn --skill systematic-debugging-dxc-danny

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides engineers to identify root causes of bugs before proposing fixes, helping avoid patching symptoms and saving time.

Core Features & Use Cases

  • Four-stage workflow: root-cause investigation, pattern analysis, hypothesis testing, and implementation, with mandatory progression through each stage.
  • Guards and reuse: collects evidence, analyzes failure modes, and documents validation to prevent regression across production, CI, and development environments.
  • Use cases: effective during production outages, flaky tests, performance regressions, and unexpected software behavior.

Quick Start

Follow the four-stage process to diagnose and fix issues by starting with root-cause investigation and ending with validated fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging process for identifying root causes?

To identify root causes of bugs, follow a four-stage workflow: root-cause investigation, pattern analysis, hypothesis testing, and implementation. This process mandates explicit progression and evidence gathering before any fixes are proposed.

How do I stop fixing symptoms instead of the actual bug?

To stop fixing symptoms, enforce a root-cause investigation stage before implementation. By analyzing failure patterns and gathering evidence through hypothesis testing, you ensure the underlying issue is resolved rather than just patching superficial behavior.

How do I debug flaky tests and production outages effectively?

Debug flaky tests and production outages by applying a systematic four-stage workflow: investigate root causes, analyze failure mode patterns, test hypotheses, and implement validated fixes. This method collects evidence to prevent future regressions across CI and production environments.

When should I use a systematic root-cause analysis for software bugs?

Use systematic root-cause analysis for software bugs during production outages, flaky tests, performance regressions, and unexpected behavior. It is essential whenever you need to prevent regression and document validation across development environments.

Does systematic debugging work without specific testing frameworks?

Yes, systematic debugging works without specific testing frameworks because it is a process-driven workflow rather than a tool dependency. It applies universally across any project to investigate failure modes and validate fixes through evidence gathering.