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.