systematic-debugging

Investigate root causes of bugs through a four-phase debugging workflow.

178|24|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection --skill systematic-debugging-zhanlincui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection/tree/main/systematic-debugging
Command: npx skills add https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection --skill systematic-debugging-zhanlincui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables a disciplined, four-phase approach to debugging to ensure root causes are identified before proposing fixes, reducing wasted effort and recurring issues.

Core Features & Use Cases

  • Phase-driven workflow: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
  • Defense-in-depth mindset: Validate data and flows across multiple layers to prevent regressions.
  • Real-world applicability: Works for bugs, test failures, production issues, and integration problems.

Quick Start

Load the systematic-debugging skill and follow the four-phase process before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and when should I use a root cause investigation process?

Systematic debugging is a structured approach to identify the root causes of bugs before proposing fixes. You should use it for any unexpected behavior, test failures, or integration issues across development, CI, or production environments to reduce recurring problems.

How do I debug recurring software issues using a phase-based workflow?

Debug recurring issues by following a four-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. This structured process enforces root-cause tracing and validates data across layers before applying any fixes.

Can I use this root-cause tracing method for production outages and CI pipeline failures?

Yes, this root-cause tracing method applies to production outages and CI pipeline failures. It is built for real-world applicability across any bug, test failure, or unexpected behavior, enforcing a defense-in-depth mindset to validate data flows in any environment.

What is the best way to fix bugs without causing regressions in complex systems?

The best way to prevent regressions is applying a defense-in-depth mindset during debugging. This involves validating data and flows across multiple system layers and completing pattern analysis and hypothesis testing before implementing the actual fix.

Why does proposing fixes immediately without pattern analysis lead to wasted debugging effort?

Proposing fixes immediately skips pattern analysis and root cause investigation, leading to wasted effort and recurring issues. A systematic, phase-based approach ensures you validate hypotheses and trace the actual root cause before implementation.