systematic-debugging

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

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/yairbederman/EngineeringAgency --skill systematic-debugging-yairbederman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/yairbederman/EngineeringAgency/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/yairbederman/EngineeringAgency --skill systematic-debugging-yairbederman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging reduces wasted effort by preventing symptom fixes and ensuring root-cause analysis before implementing any change.

Core Features & Use Cases

  • Four-phase process (Root Cause Investigation, Isolation, Hypothesis Testing, Implementation) ensures thorough analysis for any issue.
  • Emphasis on reproducibility, evidence gathering, and creating minimal reproductions to isolate triggers.
  • Applicable across production, staging, and development environments, including performance, integration, and build failures.

Quick Start

Execute Phase 1 through Phase 4 in order to resolve the issue by first identifying the root cause, then isolating and testing hypotheses, and finally implementing a safe fix.

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 patching symptoms?

Root-cause debugging identifies the exact trigger of bugs by enforcing a four-phase process: investigation, isolation, hypothesis testing, and implementation. This prevents wasted effort on symptom fixes.

What is the best way to debug test failures across staging and production environments?

Systematic debugging applies across production, staging, and development environments by focusing on consistent reproduction, evidence collection, and creating minimal reproductions to isolate the trigger.

How do I isolate a bug trigger before attempting a fix?

You isolate a bug by creating minimal reproductions and gathering evidence during the isolation phase, ensuring the exact trigger is identified before moving to hypothesis testing and implementation.

Can I use this systematic debugging approach for build and integration failures?

Yes, the four-phase debugging process is applicable to performance, integration, and build failures, ensuring thorough analysis and minimal changes across varying system complexities.

Why should I test hypotheses before implementing a bug fix?

Hypothesis testing is a required phase that validates the isolated root cause before implementation. This ensures the proposed fix is safe and prevents applying unnecessary changes to the system.