systematic-debugging

Reproduce, isolate, understand, and verify software faults with structured debugging.

Updated Sep 2, 2025
One-click install
npx skills add https://github.com/rafaelminatto1/fisioflow-51658291 --skill systematic-debugging-rafaelminatto1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/rafaelminatto1/fisioflow-51658291/tree/main/.agent/skills/systematic-debugging
Command: npx skills add https://github.com/rafaelminatto1/fisioflow-51658291 --skill systematic-debugging-rafaelminatto1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This approach provides a disciplined, 4-phase debugging workflow to reduce guesswork, accelerate root-cause discovery, and deliver verifiable fixes.

Core Features & Use Cases

  • Reproducible reproduction steps: ensures issues are reliably repeatable across environments.
  • Isolation and analysis: applies structured questions and the 5 Whys to locate root causes.
  • Verification and guardrails: validates fixes with regression checks and documentation to prevent recurrence.

Quick Start

Describe the failure scenario clearly and follow the four phases to reproduce, isolate, understand, and verify the 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 debugging workflow for finding root causes?

A structured debugging workflow systematically identifies and resolves faults through four phases: reproducing the issue, isolating the failure, understanding the root cause, and verifying the fix. This eliminates guesswork and ensures traceable outcomes.

How do I isolate a software fault using the 5 Whys technique?

To isolate a software fault, you apply the 5 Whys technique by repeatedly asking why the failure occurs, guided by structured questions. This methodical isolation process narrows down potential causes until the actual root cause is located.

What is the best way to verify a code fix and prevent regression?

The best way to verify a code fix is to apply regression checks and document the resolution process. This evidence-based verification validates that the fix works and establishes guardrails to prevent future recurrence across runtime environments.

How do I ensure software troubleshooting steps are reproducible across environments?

To ensure troubleshooting steps are reproducible, clearly describe the failure scenario and establish reliable repetition steps. This disciplined reproduction phase confirms the issue is consistently repeatable before moving to isolation and analysis.

Can I use this systematic debugging approach for any runtime environment?

Yes, you can apply this systematic debugging approach across diverse software projects and runtime environments. It provides deterministic workflows and comprehensive checklists that guide developers through root-cause analysis regardless of the specific platform.

Why does guessing during troubleshooting slow down root-cause analysis?

Guessing during troubleshooting slows down root-cause analysis because it lacks traceable evidence. A disciplined, evidence-based workflow reduces guesswork by systematically reproducing, isolating, and verifying fixes, which accelerates discovery and resolution.