systematic-debugging

Enforce a four-phase debugging methodology to identify and resolve root causes.

1|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/icyzh/hermes-web --skill systematic-debugging-icyzh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/icyzh/hermes-web/tree/main/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/icyzh/hermes-web --skill systematic-debugging-icyzh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the cycle of guessing and patching symptoms by enforcing a rigorous, four-phase investigation process that ensures bugs are understood before any code is changed.

Core Features & Use Cases

  • Root Cause Investigation: Provides a structured framework to read error messages, trace data flow, and build deterministic feedback loops.
  • Scientific Hypothesis Testing: Guides the user to form ranked, falsifiable hypotheses and test them one variable at a time.
  • Use Case: When a production bug is reported, use this skill to construct a tight reproduction script, isolate the failing component, and verify the fix with a regression test, preventing the common trap of introducing new bugs through hasty patches.

Quick Start

Use the systematic-debugging skill to investigate the failing test case in the current directory by following the four-phase process.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is the best way to find the root cause of a production bug instead of patching symptoms?▼

Root cause analysis for production bugs requires a systematic debugging methodology that enforces rigorous evidence gathering and isolated hypothesis testing to ensure durable fixes.

How do I debug a failing test case systematically without introducing new issues?▼

To debug a failing test case, follow a four-phase investigation process: systematically reproduce the failure, gather evidence, form falsifiable hypotheses, and verify the fix with a regression test.

How does scientific hypothesis testing work for troubleshooting software problems?▼

Scientific hypothesis testing for troubleshooting software problems involves forming ranked, falsifiable hypotheses and testing them one variable at a time to isolate the failing component.

Can I use systematic debugging for performance regressions and test failures, or only production bugs?▼

Systematic debugging applies to performance regressions and test failures alongside production bugs, enforcing a structured framework to trace data flow and build deterministic feedback loops.

Why do my quick bug fixes keep causing new problems in my software development workflow?▼

Quick bug fixes cause new problems because they patch symptoms without understanding the root cause; a rigorous investigation process with deterministic feedback loops prevents hasty patches.

How do I build a tight reproduction script to isolate a failing component?▼

Building a tight reproduction script requires systematic reproduction of the issue and evidence gathering to trace data flow, enabling you to isolate the failing component before applying fixes.