systematic-debugging

Identify and resolve root causes of bugs through a four-phase debugging process.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/iinoshirozheng/SinoCloudChat --skill systematic-debugging-iinoshirozheng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/iinoshirozheng/SinoCloudChat/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/iinoshirozheng/SinoCloudChat --skill systematic-debugging-iinoshirozheng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a disciplined, four-phase framework to uncover root causes before proposing fixes, reducing wasted effort and rework.

Core Features & Use Cases

  • Phase-driven investigation: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation.
  • Anti-shortcut guidance: STOP and re-analyze when faced with pressure or complexity.
  • Defense-in-depth: multi-layer validation and instrumentation to prevent symptom fixes.

Quick Start

Follow Phase 1 to Phase 4 in order before attempting 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 bug instead of just fixing the symptom?

To find the root cause of a bug, follow a disciplined four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. This prevents symptom fixes by enforcing analysis before applying fixes.

What is the best way to debug a production outage across multi-service architectures?

Debugging a production outage across multi-service architectures requires a systematic approach using pattern analysis and hypothesis testing. A phase-driven investigation identifies root causes before implementation, applying defense-in-depth practices to prevent recurring failures.

How do I systematically debug flaky test failures during incident response?

Systematically debug flaky test failures by applying root cause investigation and pattern analysis before fixing. The framework enforces non-skipping rules, requiring you to STOP and re-analyze under pressure to avoid patching symptoms.

Does defense-in-depth debugging work for complex software development failures?

Defense-in-depth debugging works for complex software development failures by applying multi-layer validation and instrumentation. This framework enforces a strict four-phase process to ensure fixes target actual root causes rather than surface symptoms.

What are the limitations of using a systematic debugging framework during high-pressure on-call incidents?

The limitation of systematic debugging during high-pressure incidents is the temptation to skip phases. The framework mitigates this with anti-shortcut guidance, forcing you to STOP and re-analyze complexity rather than rushing a premature fix.

How do I start root cause tracing before applying code fixes?

Start root cause tracing by executing Phase 1 through Phase 4 in strict order before attempting any fix. This requires pattern analysis and hypothesis testing to validate the true source of the failure across your architecture.