systematic-debugging

Guide root-cause investigation through a four-phase debugging process.

Updated May 5, 2026
One-click install
npx skills add https://github.com/XCmiaow/cc-deploy --skill systematic-debugging-xcmiaow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/XCmiaow/cc-deploy/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/XCmiaow/cc-deploy --skill systematic-debugging-xcmiaow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

It prevents wasted time from guess-and-check debugging by forcing a root-cause investigation before proposing any fixes, reducing flakiness, rework, and symptom whack-a-mole.

Core Features & Use Cases

  • Root-cause-first workflow: Enforces the Iron Law to avoid proposing fixes until Phase 1 is complete.
  • Four-phase debugging process: Investigation → Pattern Analysis → Hypothesis & Testing → Implementation.
  • Pressure-resistant guardrails: Includes explicit red flags (e.g., “STOP and re-analyze”) and guidance for when you don’t understand the issue.
  • Multi-component evidence gathering: Provides a structured approach to trace failures across boundaries by instrumenting inputs/outputs at each layer.
  • Test-before-fix requirement: Requires a failing test case in Phase 4 when possible.

Quick Start

Use systematic-debugging when you hit a bug, test failure, or unexpected behavior, and ask an AI to follow Phase 1 Root Cause Investigation before suggesting any fixes.

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 flaky tests instead of just fixing symptoms?

To find the root cause of flaky tests, you must complete a full root-cause investigation before proposing any fixes. This systematic debugging approach enforces pattern analysis and single-hypothesis minimal testing to eliminate symptom whack-a-mole and reduce rework.

What is the best way to debug failures deep in a multi-component call stack?

The best way to debug deep call stack failures is multi-component evidence gathering, instrumenting inputs and outputs at each layer. This structured approach traces failures across boundaries before you attempt any root-cause implementation or verification.

How do I systematically debug unexpected system behavior and build failures?

You systematically debug unexpected system behavior and build failures using a four-phase process: Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. Pressure-resistant guardrails stop you from guessing by forcing re-analysis when you don't understand the issue.

Why do my bug fixes cause rework and how can hypothesis testing prevent it?

Bug fixes cause rework when you guess-and-check without understanding the root cause. Hypothesis testing prevents rework by requiring a failing test case during implementation, verifying that your single-hypothesis minimal testing directly addresses the actual failure.

Does this debugging method work for performance regressions and integration issues?

Yes, this debugging method works for performance regressions and integration issues. It applies to bugs, build failures, and unexpected behavior across multi-component pipelines by requiring pattern analysis and root-cause verification before any code changes.