systematic-debugging

Trace root causes of technical bugs through a four-phase investigation workflow.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/yckkkk/reo --skill systematic-debugging-yckkkk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/yckkkk/reo/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/yckkkk/reo --skill systematic-debugging-yckkkk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined approach to identify and trace root causes of bugs before applying fixes, reducing wasted effort on symptom-only patches and helping teams operate under time pressure without backsliding into guesswork.

Core Features & Use Cases

  • Phase-based workflow covering Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
  • Anti-patterns and guardrails that resist shortcut fixes and encourage thorough analysis.
  • Support for root-cause tracing, defense-in-depth practices, and structured decision making under pressure.
  • Real-world guidance on applying the method across test failures, production incidents, and complex multi-component systems.

Quick Start

Load the skill and follow Phase 1 through Phase 4 in order to identify root causes before implementing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is root-cause debugging and why is it necessary before applying fixes?

Root-cause debugging systematically traces the underlying cause of bugs before implementing fixes, reducing wasted effort on symptom-only patches and preventing recurring issues under time pressure.

How do I trace production bugs and test failures using a structured debugging workflow?

Trace production bugs and test failures by following a four-phase debugging workflow: root cause investigation, pattern analysis, hypothesis testing, and implementation, ensuring thorough analysis before any code changes.

Can I use this systematic debugging method for complex multi-component systems?

Yes, systematic debugging applies to complex multi-component systems, providing real-world guidance and structured decision-making to identify root causes across diverse technical issues and performance problems.

What is the best way to stop guesswork and shortcut fixes during incident investigation?

The best way to stop guesswork is using anti-pattern guardrails and defense-in-depth practices that resist shortcut fixes, enforcing structured analysis throughout the debugging process under time pressure.

How do I test a debugging hypothesis before implementing a code fix?

Test a debugging hypothesis during the dedicated hypothesis and testing phase, validating your root-cause analysis against the observed technical issue before moving to the implementation phase.