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.