systematic-debugging

Enforce a four-phase root-cause debugging workflow with explicit gates.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bearhedge/APE-YOLO --skill systematic-debugging-bearhedge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/bearhedge/APE-YOLO/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/bearhedge/APE-YOLO --skill systematic-debugging-bearhedge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined framework for debugging deep bugs by prioritizing root-cause analysis over quick patches, reducing wasted time and stabilizing systems.

Core Features & Use Cases

  • Four-Phase Methodology: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation with explicit success criteria.
  • Anti-patterns and Defenses: Clear rules to stop shortcutting and ensure robust fixes.
  • Defense-in-Depth Guidance: Strategies for tracing data flow, adding layered validations, and instrumentation.

Quick Start

Load the systematic-debugging skill and begin at Phase 1: Root Cause Investigation. Read the error context, reproduce the issue, collect evidence, and then proceed to Phase 2 if Phase 1 is complete.

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 production bug instead of just patching symptoms?

To find the root cause of a production bug, follow a systematic four-phase methodology: Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation. This enforces evidence collection and traceability to prevent hurried, symptom-focused fixes.

What is the best way to debug complex software integration faults?

The best way to debug integration faults is using a phase-based debugging workflow with explicit movement gates. This ensures you reproduce the issue, collect evidence, and validate hypotheses before implementing a fix, reducing wasted time and stabilizing systems.

How do I stop taking shortcuts when debugging test failures?

To stop shortcutting during debugging, apply defined anti-patterns and defense-in-depth practices. This enforces rigorous root-cause analysis by tracing data flow and adding layered validations, ensuring robust fixes rather than quick patches.

Can I use a systematic debugging approach for performance problems?

Yes, you can use a systematic debugging approach for performance problems. The methodology applies to any technical issue, including performance degradation, by requiring explicit success criteria and hypothesis testing before moving to implementation.

How do I trace data flow to validate a bug fix?

To trace data flow and validate a bug fix, apply defense-in-depth guidance during the implementation phase. This involves adding layered validations and instrumentation to ensure the fix resolves the root cause without introducing regressions.