systematic-debugging

Enforce four-phase root-cause analysis before proposing fixes for technical bugs.

9|2|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/DmitriyPolukhin/antigravity-superpower --skill systematic-debugging-dmitriypolukhin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/DmitriyPolukhin/antigravity-superpower/tree/main/modules/systematic-debugging
Command: npx skills add https://github.com/DmitriyPolukhin/antigravity-superpower --skill systematic-debugging-dmitriypolukhin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted time, flakiness, and recurring bugs by forcing disciplined root-cause investigation before any fixes are proposed.

Core Features & Use Cases

  • Four-phase debugging workflow: Root Cause Investigation → Pattern Analysis → Hypothesis & Testing → Implementation.
  • Anti-rationalization guardrails: Enforces the “no fixes without root cause investigation first” rule, with explicit red flags and escalation when multiple fixes fail.
  • Works for any technical failure: Suitable for test failures, production bugs, unexpected behavior, performance/build/integration issues, especially under time pressure.

Quick Start

Ask your AI to debug the failure using the systematic debugging phases and to stop immediately if it tries to propose fixes before completing Phase 1.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I fix recurring technical bugs instead of just patching symptoms?

Fix recurring technical bugs by enforcing a four-phase root cause investigation workflow before proposing any changes. This prevents wasted time and thrashing by requiring pattern analysis and hypothesis testing to resolve the underlying issue.

What's the best way to debug flaky tests and CI build failures systematically?

Debug flaky tests and CI build failures systematically by forming a single hypothesis with minimal tests, creating a failing test for the root-cause fix, and stopping to re-analyze architecture after multiple failed fixes.

Why does my debugging process thrash when I guess fixes for production incidents?

Debugging production incidents thrashes because guessing fixes without root cause investigation leads to wasted effort and recurring bugs. Disciplined hypothesis testing and pattern analysis are required to stop the cycle.

How do I carry out root cause analysis for unexpected behavior in production?

Carry out root cause analysis for unexpected behavior by completing four phases: root cause investigation, pattern analysis, hypothesis with testing, and implementation, ensuring disciplined analysis before any code changes.

When should I stop trying fixes and re-analyze architecture during incident response?

During incident response, stop trying fixes and re-analyze architecture when multiple fixes fail, triggering explicit red flags and escalation to prevent further thrashing and wasted time.

Does systematic debugging work for integration problems and performance issues?

Systematic debugging works for integration problems and performance issues by applying a disciplined four-phase workflow with anti-rationalization guardrails to any technical failure scenario, including build and integration problems.