systematic-debugging

Guide root-cause analysis with a four-phase debugging workflow.

Updated Aug 22, 2025
One-click install
npx skills add https://github.com/AnthonyCongHieu/voice_tool --skill systematic-debugging-anthonyconghieu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/AnthonyCongHieu/voice_tool/tree/main/voice_tools_v1/.agent/skills/systematic-debugging
Command: npx skills add https://github.com/AnthonyCongHieu/voice_tool --skill systematic-debugging-anthonyconghieu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured debugging methodology that prevents guesswork and guides teams through root-cause analysis with evidence-based verification.

Core Features & Use Cases

  • Four-phase workflow: Reproduce, Isolate, Understand, and Fix & Verify, plus practical checklists and root-cause techniques.
  • Reproducibility and isolation-focused guidance to reliably detect and verify issues across environments.
  • Use cases include complex software defects, intermittent bugs, and scenarios requiring robust verification before release.

Quick Start

Describe the issue clearly and let the assistant walk you through reproducing, isolating, understanding, and verifying the fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I debug complex software defects using root-cause analysis?

To debug complex software defects using root-cause analysis, follow a structured four-phase workflow: Reproduce, Isolate, Understand, and Fix & Verify. This methodology prevents guesswork by applying evidence-based checks and isolation protocols across environments.

What is the best way to reproduce intermittent bugs across different environments?

The best way to reproduce intermittent bugs is to apply a dedicated reproduction protocol within a structured debugging workflow. This ensures reliable issue detection across environments by focusing on reproducibility before attempting any code fixes.

How do I isolate a software bug to find its exact origin?

To isolate a software bug, apply isolation checks from a structured debugging workflow. This process narrows down multi-step variables across codebases, ensuring you pinpoint the exact origin before proceeding to cause analysis.

When do I need a structured debugging workflow instead of ad-hoc troubleshooting?

You need a structured debugging workflow when dealing with complex software defects, intermittent bugs, or scenarios requiring robust verification before release. It replaces ad-hoc troubleshooting with evidence-based root-cause analysis to ensure fixes are robust.

How do I verify a software fix is robust before release?

To verify a software fix is robust before release, apply verification criteria from the final phase of a structured debugging workflow. This ensures the fix resolves the root cause without introducing regressions across your environments.

Can I use the 5 Whys technique for root-cause analysis in software debugging?

Yes, you can use the 5 Whys technique for root-cause analysis in software debugging. It serves as a cause analysis tool within the Understand phase to systematically identify the underlying reasons behind complex defects.