systematic-debugging

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Systematic debugging helps teams avoid patching symptoms by enforcing root-cause investigation before fixes, reducing cycle time and rework.

Core Features & Use Cases

  • Four-phase workflow (root-cause investigation, pattern analysis, hypothesis testing, implementation) to structure debugging efforts.
  • Evidence-driven diagnosis with guided data collection, reproducibility checks, and traceability.
  • Use Case: When a bug or failure arises, apply this skill to identify the underlying cause and prevent recurring issues.

Quick Start

Describe a bug, reproduce it consistently, and begin Phase 1: Root Cause Investigation.

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 patching symptoms?

To find the root cause of a bug, you need a systematic debugging workflow that enforces evidence gathering, pattern analysis, and hypothesis testing before implementation. This prevents patching symptoms and reduces rework.

What is the best way to debug production failures and integration problems?

Debugging production failures and integration problems requires a four-phase root-cause investigation workflow: evidence collection, pattern analysis, hypothesis testing, and controlled implementation with explicit exit criteria.

How do I systematically reproduce test failures for root-cause analysis?

To systematically reproduce test failures for root-cause analysis, you must establish consistent reproduction steps and gather diagnostic evidence during the initial investigation phase before proposing any fixes.

Can I use systematic debugging for performance issues and build failures?

Yes, systematic debugging is applicable to performance issues and build failures. It enforces root-cause investigation and hypothesis testing across all unexpected software behavior, ensuring reliable fixes.

Why does fixing a bug without pattern analysis lead to recurring issues?

Fixing a bug without pattern analysis leads to recurring issues because symptom patching ignores the underlying root cause. Hypothesis testing and evidence-driven diagnosis are required to prevent regression.

What are the limitations of using a root-cause debugging workflow?

The limitation of root-cause debugging is its strict four-phase requirement: you must complete investigation, pattern analysis, and hypothesis testing with explicit exit criteria before implementation, which may slow down urgent hotfixes.