systematic-debugging

Guide a four-phase debugging process to identify and resolve root causes.

947|163|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/guanyang/antigravity-skills --skill systematic-debugging-guanyang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/guanyang/antigravity-skills/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/guanyang/antigravity-skills --skill systematic-debugging-guanyang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents wasted time and introduced bugs by ensuring that the root cause of any issue is identified and addressed before any fixes are implemented. It provides a structured, pressure-resistant process for debugging.

Core Features & Use Cases

  • Four-Phase Process: Guides users through Investigation, Pattern Analysis, Hypothesis, and Implementation.
  • Root Cause Mandate: Emphasizes finding the fundamental issue, not just patching symptoms.
  • Pressure Resistance: Includes specific language and rules to prevent shortcuts under time pressure.
  • Use Case: When a critical production bug appears, use this Skill to systematically trace the issue to its origin, ensuring a robust fix rather than a temporary workaround.

Quick Start

Use the systematic-debugging skill to guide your investigation of the current bug.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging process for finding the root cause of software bugs?

A systematic debugging process traces software bugs to their fundamental origin through four phases: investigation, pattern analysis, hypothesis formation, and implementation. This structured approach ensures you resolve the root cause rather than merely patching symptoms.

How do I stop fixing symptoms and find the true root cause of unexpected behavior?

To find the true root cause of unexpected behavior, follow a structured investigation process that mandates hypothesis formation and pattern analysis before implementing any fixes. This prevents symptom patching and avoids introducing new bugs.

What is the best way to troubleshoot critical production bugs under time pressure?

The best way to troubleshoot critical production bugs under time pressure is to use a pressure-resistant debugging process. It enforces specific rules to prevent shortcuts, ensuring you systematically trace the issue to its origin for a robust fix instead of a temporary workaround.

How do I investigate test failures systematically without introducing new issues?

To investigate test failures without introducing new issues, apply a four-phase debugging workflow: investigate the failure, analyze patterns, form a hypothesis about the root cause, and only then implement the fix. This prevents wasted time and further regressions.

Does this systematic troubleshooting method work for all technical issues?

Yes, this systematic troubleshooting method is applicable to all technical issues, including bugs, test failures, and unexpected behavior. It provides a universal, structured process to identify and resolve the fundamental root cause across any technical context.

When should I avoid symptom fixing during bug fixing?

You should avoid symptom fixing during bug fixing whenever a critical production bug appears or unexpected behavior persists. Always mandate identifying the fundamental issue first to ensure a robust fix rather than applying a temporary workaround that wastes time.