systematic-debugging

Apply a four-phase debugging workflow to identify and eliminate root causes.

31|3|Updated May 7, 2026
One-click install
npx skills add https://github.com/markwang2658/hermes-windows-native --skill systematic-debugging-markwang2658
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/markwang2658/hermes-windows-native/tree/main/hermes-agent/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/markwang2658/hermes-windows-native --skill systematic-debugging-markwang2658

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined, phase-based approach to identifying and resolving software defects by prioritizing root-cause investigation over quick fixes.

Core Features & Use Cases

  • Phase-driven analysis (Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation)
  • Tools for evidence gathering, reproducibility, and traceability
  • Real-world applicability: debugging flaky tests, production issues, and is suitable for teams adopting TDD or CI workflows

Quick Start

Begin by reading the error messages and reproducing the issue to establish a reliable baseline.

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 it for root-cause analysis?

Systematic debugging is a disciplined, four-phase workflow for root-cause investigation that prioritizes evidence gathering and structured experimentation over quick fixes. Use it to resolve production incidents, flaky tests, and multi-component system regressions.

How do I find the root cause of a bug using a structured debugging process?

To find a root cause, apply four phases: root-cause investigation, pattern analysis, hypothesis testing, and implementation. Begin by reproducing the issue to establish a reliable baseline, gather rigorous data, and run structured experiments to uncover the true cause.

Can I use systematic debugging for flaky tests and production incidents?

Yes, systematic debugging supports real-world applicability for debugging flaky tests, production issues, and development-time regressions. It provides phase-driven analysis and tools for evidence gathering, reproducibility, and traceability across these environments.

Does a systematic debugging workflow integrate with TDD and CI pipelines?

Yes, this approach is suitable for teams adopting TDD or CI workflows. It integrates with existing testing practices by using deterministic phases to investigate root causes, ensuring that bug resolution aligns with continuous integration testing standards.

What is the best way to debug multi-component systems without applying quick fixes?

The best way to debug multi-component systems is using a phase-based debugging workflow. It emphasizes rigorous data gathering, reproducible steps, and structured experimentation to uncover the true cause, rather than applying patches that mask underlying issues.

Why should I reproduce an error before starting root-cause investigation?

Reproducing an error establishes a reliable baseline for systematic debugging. This initial step in root-cause investigation ensures you have consistent, verifiable conditions to gather evidence and conduct structured hypothesis testing accurately.