systematic-debugging

Identify root causes of bugs through a four-phase debugging process.

6|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/futuregerald/futuregerald-claude-plugin --skill systematic-debugging-futuregerald
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/futuregerald/futuregerald-claude-plugin/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/futuregerald/futuregerald-claude-plugin --skill systematic-debugging-futuregerald

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging guides engineers to identify root causes of bugs before proposing fixes, reducing wasted effort and rework.

Core Features & Use Cases

  • Four-phase framework: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, Implementation with explicit rules.
  • Anti-patterns and defense-in-depth guidance to prevent shortcut fixes.
  • Real-world testing and iteration patterns to validate fixes before completion.

Quick Start

Follow Phase 1 through Phase 4 to identify root cause before implementing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of a bug instead of just fixing symptoms?▼

To find a root cause before fixing symptoms, follow a systematic debugging framework that enforces a four-phase process: root cause investigation, pattern analysis, hypothesis testing, and implementation. This prevents wasted effort on shortcut fixes.

What is the best way to debug production issues systematically?▼

The best way to debug production issues is applying a phased debugging framework that enforces root cause investigation, pattern analysis, hypothesis testing, and implementation with explicit defenses and phase gates to prevent premature patching.

How do I stop applying shortcut fixes when debugging test failures?▼

To stop applying shortcut fixes when debugging test failures, use a defense-in-depth approach with explicit anti-pattern guidance and phase gates that force you to validate a root cause hypothesis before any implementation begins.

Can I use a systematic debugging process for integration problems?▼

Yes, you can use a systematic debugging process for integration problems. The four-phase framework applies directly to integration issues by enforcing root cause investigation and hypothesis testing before applying any code fixes.

What are the steps to validate a bug fix before completing implementation?▼

To validate a bug fix before completing implementation, follow the real-world testing and iteration patterns provided in the hypothesis testing and implementation phases to ensure your root cause analysis is correct.

When should I not use a trial-and-error approach for debugging?▼

You should avoid trial-and-error debugging when facing complex test failures, production issues, or integration problems, and instead use a systematic four-phase process to identify root causes and reduce rework.