systematic-debugging

Debug software issues through a four-phase root cause investigation process.

Updated Mar 10, 2026
One-click install
npx skills add https://github.com/BryceRoberts13/superpowers-for-antigravity --skill systematic-debugging-bryceroberts13
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/BryceRoberts13/superpowers-for-antigravity/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/BryceRoberts13/superpowers-for-antigravity --skill systematic-debugging-bryceroberts13

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically debug bugs, test failures, and unexpected behavior to uncover the root cause before proposing fixes.

Core Features & Use Cases

  • Phase-based, four-step process: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation
  • Guardrails, anti-patterns, and defense-in-depth to prevent shortcuts and regressions
  • References and practical examples to improve debugging discipline across teams

Quick Start

Start by selecting a failing scenario and follow Phase 1 to gather evidence before attempting any fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is the best way to debug flaky tests and find the root cause?

Root-cause debugging of flaky tests requires systematically tracing data flow and gathering evidence before attempting any fix. This four-phase process enforces guardrails and defense-in-depth to prevent regressions and ensure robust resolutions.

How do I systematically debug production bugs without introducing regressions?

Systematically debug production bugs by following a four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation. This enforces guardrails and defense-in-depth to uncover the true root cause and prevent shortcuts that introduce regressions.

Why does my debugging process often fail to fix unexpected software behavior permanently?

Debugging fails when shortcuts bypass root-cause investigation, leading to superficial fixes. Applying a structured, phase-based process with pattern analysis and hypothesis testing ensures you uncover the actual root cause before implementing a permanent resolution.

Can I use a phase-based debugging approach for performance problems?

Yes, a phase-based debugging approach applies to performance problems by guiding investigators to trace data flow and validate hypotheses. It ensures you gather evidence and analyze patterns to uncover the root cause before implementing and documenting fixes.

How to start systematic debugging when facing test failures?

Start systematic debugging by selecting the failing scenario and entering Phase 1 to gather evidence. Trace the data flow and investigate the root cause thoroughly before moving to pattern analysis, hypothesis testing, and implementation.

When should I not use a systematic root-cause debugging approach?

You should not skip systematic root-cause debugging for complex software issues, as avoiding it risks regressions. However, for trivial fixes, the strict four-phase process with guardrails may be more overhead than necessary, though it always ensures auditable resolutions.