systematic-debugging

Trace data flow and apply a four-phase process to fix root causes.

437|13|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/derHaken/SuperAntigravity --skill systematic-debugging-derhaken
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/derHaken/SuperAntigravity/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/derHaken/SuperAntigravity --skill systematic-debugging-derhaken

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically identifies root causes of bugs and failures before applying fixes.

Core Features & Use Cases

  • Four-phase debugging framework: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis & Testing, Phase 4 Implementation.
  • Applicable to errors across software stacks: unit tests, integration issues, production incidents, and performance bugs.
  • Encourages evidence gathering, reproducibility, and trace-data flow analysis to prevent symptom fixes.

Quick Start

Start Phase 1 by documenting the observable error, reproducing it consistently, and gathering evidence before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What's the best way to find the root cause of a software bug before fixing it?

To find a bug's root cause, you must first identify its observable behavior and reproduce it reliably to establish a baseline, then trace data flow across components to gather evidence before applying fixes.

How do I systematically debug production incidents and unit test failures?

Systematically debug production incidents and unit test failures by applying a four-phase process: investigate root cause, analyze patterns, test hypotheses, and implement the verified resolution to prevent symptom fixes.

Why does my software fix only treat the symptom instead of the root cause?

Your software fix treats symptoms instead of the root cause if you skip evidence gathering and data flow tracing. Reproducing the error consistently and analyzing failure points ensures you resolve the actual issue.

Can I use this debugging framework for performance bugs and integration issues?

Yes, you can use this debugging framework for performance bugs and integration issues. It is applicable to errors across software stacks, guiding you to capture environment changes and collect error messages.

How do I start phase 1 of a root-cause investigation?

Start phase 1 of a root-cause investigation by documenting the observable error, reproducing it consistently, and gathering evidence like error messages and environment changes before proposing any fixes.

What are the limitations of tracing data flow to determine failure points?

Tracing data flow to determine failure points requires capturing consistent environment changes and reproducing the bug reliably; if the error is intermittent or environment data is missing, root cause scope becomes harder to define.