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.