systematic-debugging

Diagnose software bugs through a four-phase reproduce, isolate, understand, and verify workflow.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/raccioly/coach-gravity --skill systematic-debugging-raccioly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/raccioly/coach-gravity/tree/main/content/starter-kit/skills/systematic-debugging
Command: npx skills add https://github.com/raccioly/coach-gravity --skill systematic-debugging-raccioly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured approach to debugging that prevents random guessing and ensures problems are properly understood before solving.

Core Features & Use Cases

  • Reproduce-driven debugging: establish reliable reproduction steps to observe the issue.
  • Phase-based analysis: guide through Reproduce, Isolate, Understand, and Fix & Verify with checklists and evidence.
  • Verification & learning: document root causes, outcomes, and prevention for future changes.

Quick Start

Apply the four-phase debugging process to reproduce, isolate, understand, and verify a fix for your issue.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging workflow for complex software bugs?

A systematic debugging workflow prevents random guessing by enforcing a structured, evidence-based process. It guides teams through reproducing the issue, isolating variables, understanding the root cause, and verifying the fix.

How do I troubleshoot production incidents without randomly guessing the root cause?

Troubleshoot production incidents by applying a phase-based analysis framework. Establish reliable reproduction steps to observe the issue, then use explicit checklists to isolate variables and gather evidence before attempting a fix.

Can I use this debugging method across different programming languages and environments?

Yes, this debugging method is applicable across languages and environments. It focuses on a reproducible, evidence-based workflow rather than language-specific syntax, making it suitable for diverse software engineering contexts.

What's the best way to verify a bug fix and prevent future regressions?

The best way to verify a bug fix is through the Fix and Verify phase, which requires verifiable evidence. It includes documenting root causes, outcomes, and prevention strategies to guide future changes and prevent regressions.

Does structured root-cause analysis work for both major incidents and small fixes?

Structured root-cause analysis works for both major production incidents and small fixes. The four-phase process scales to enforce reliable reproduction and evidence-based understanding regardless of the issue's severity.