systematic-debugging

Enforce a 4-phase debugging workflow to identify and verify root causes.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/AnvinX1/med-rag --skill systematic-debugging-anvinx1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/AnvinX1/med-rag/tree/main/medical_genai_app/.agent/skills/systematic-debugging
Command: npx skills add https://github.com/AnvinX1/med-rag --skill systematic-debugging-anvinx1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This systematic debugging approach eliminates guesswork by enforcing a four-phase process that leads to reliable root-cause identification and evidence-based verification.

Core Features & Use Cases

  • Structured phases: Reproduce, Isolate, Understand, and Fix & Verify, with checklists and templates.
  • Root-cause analysis: Guides through the 5 Whys and targeted questions to uncover underlying causes.
  • Use Case: When debugging a flaky service, apply this method to reproduce consistently, isolate the failure, analyze root cause, implement a fix, and verify regression checks.

Quick Start

Reproduce the issue using the built-in checklists, then proceed through isolation, understanding, and verification to ensure a durable fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a structured workflow for software debugging instead of guessing?

A structured debugging workflow enforces a four-phase process—reproduce, isolate, understand, and fix and verify—to identify root causes through evidence rather than guesswork. This method replaces trial-and-error with systematic root-cause analysis.

How do I reproduce a flaky service failure for troubleshooting?

To reproduce a flaky service failure, you follow a reproducibility checklist that enforces consistent conditions for the issue. This structured approach captures exact failure states before narrowing down the problem scope.

How do I perform root cause analysis on complex software issues across scripts and environments?

You perform root cause analysis on complex software issues by applying targeted techniques like the 5 Whys within an isolation and understanding phase. This guides you to uncover underlying causes across codebases rather than treating symptoms.

What is the best way to verify a bug fix and prevent regressions?

The best way to verify a bug fix and prevent regressions is to apply explicit verification criteria after implementing the change. This ensures your fix is durable and validated against the original reproduction steps.

Can I use this systematic debugging method for issues in any codebase or environment?

Yes, you can apply this systematic debugging method to complex software issues across diverse codebases, scripts, and environments. It provides general reproducibility checklists and root-cause analysis prompts independent of specific dependencies.

Why does guessing fail when fixing complex software bugs?

Guessing fails when fixing complex software bugs because it skips reproducing and isolating the failure, leading to superficial fixes. A structured routine enforces evidence-based understanding to ensure the root cause is actually resolved.