systematic-debugging

Guide engineers through a four-phase workflow to uncover bug root causes.

66|20|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/cooker/wxHm --skill systematic-debugging-cooker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/cooker/wxHm/tree/main/.cursor/skills/systematic-debugging
Command: npx skills add https://github.com/cooker/wxHm --skill systematic-debugging-cooker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined, phase-driven approach to identifying root causes instead of applying quick symptom fixes, reducing waste and rework.

Core Features & Use Cases

  • Four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
  • Evidence-driven: Requires reproducible steps, data collection, and references to guide decisions.
  • Defense-in-depth mindset: Encourages multi-layer validation to prevent regression and blind spots.
  • Use Case: When a production outage or flaky bug occurs, follow the four phases to locate the root cause and deploy a durable fix.

Quick Start

Load the skill, read the overview, complete Phase 1 (Root Cause Investigation), then Phase 2 (Pattern Analysis), Phase 3 (Hypothesis & Testing), and Phase 4 (Implementation) before proposing any fix.

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 workflow for uncovering root causes?

Systematic debugging is a disciplined, four-phase workflow that guides engineers to uncover root causes of bugs instead of applying quick symptom fixes, reducing waste and rework. It enforces evidence gathering, reproducible steps, and defensive validation across the lifecycle.

How do I debug a production outage or flaky test to avoid premature fixes?

To debug a production outage or flaky test, follow the four-phase workflow: complete Root Cause Investigation, then Pattern Analysis, Hypothesis & Testing, and Implementation before proposing any fix. This phase-based approach requires data collection and reproducible steps to guide decisions.

What's the best way to trace the root cause of complex integrations?

The best way to trace root causes of complex integrations is applying a defense-in-depth mindset with multi-layer validation. This prevents regression and blind spots by requiring evidence-driven references and reproducible steps to guide decisions before implementing a durable fix.

When do I need a phase-based approach for troubleshooting software bugs?

You need a phase-based approach for troubleshooting when complex bugs, outages, or flaky tests occur and quick symptom fixes are failing. It enforces evidence gathering and hypothesis testing to reduce rework and speed recovery by locating the actual root cause.

Does root-cause-analysis require reproducible steps before hypothesis testing?

Yes, root-cause-analysis requires reproducible steps and data collection during the Root Cause Investigation phase before moving to Hypothesis & Testing. This evidence-driven approach ensures decisions are guided by actual references rather than assumptions, preventing premature fixes.