systematic-debugging

Apply a four-phase framework to identify root causes before implementing fixes.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/CaptainPhantasy/floyd-v5 --skill systematic-debugging-captainphantasy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/CaptainPhantasy/floyd-v5/tree/main/extensibility/skills/workflows/systematic-debugging
Command: npx skills add https://github.com/CaptainPhantasy/floyd-v5 --skill systematic-debugging-captainphantasy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Root-cause debugging focuses on understanding and diagnosing failures before proposing fixes, reducing time spent on symptomatic patches and reoccurring issues.

Core Features & Use Cases

  • Four-phase framework: root cause investigation, pattern analysis, hypothesis testing, implementation
  • Evidence-driven approach: replicates issues, traces data flow, and validates fixes
  • Applicable to any technical issue: bugs, test failures, performance problems, and integration faults

Quick Start

Follow the four phases to investigate and resolve issues before implementing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and when do I need it for software issues?

Systematic debugging is a structured investigation process to identify root causes before applying fixes. You need it for software issues like production bugs, test failures, and integration faults to prevent symptomatic patches and reoccurring problems.

How do I find the root cause of a bug before patching it?

To find a bug's root cause, follow a four-phase framework: investigate the root cause, analyze patterns, test hypotheses, and implement the fix. This structured approach enforces evidence collection and guarded change management.

Can I use this debugging framework for integration faults and performance problems?

Yes, you can use this debugging framework for integration faults and performance problems. The four-phase investigation applies to any technical issue across multi-component systems, ensuring evidence-driven pattern analysis and hypothesis testing.

What is the best way to debug test failures across multi-component systems?

The best way to debug test failures across multi-component systems is an evidence-driven approach that replicates issues, traces data flow, and validates fixes. This ensures accurate hypothesis testing and root cause discovery.

Why does applying quick patches lead to reoccurring software issues?

Applying quick patches leads to reoccurring software issues because it treats symptoms without discovering the underlying failure. Root-cause debugging prevents this by enforcing pattern analysis and hypothesis testing before implementation.