systematic-debugging

Identify root causes of bugs using a four-phase debugging workflow.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/svo/knowledge-matchmaker-corpus-indexer --skill systematic-debugging-svo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/svo/knowledge-matchmaker-corpus-indexer/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/svo/knowledge-matchmaker-corpus-indexer --skill systematic-debugging-svo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers avoid common debugging pitfalls by enforcing a disciplined, four-phase approach to root-cause analysis before proposing fixes.

Core Features & Use Cases

  • Phase-driven investigation: always perform root-cause investigation before any fix.
  • Pattern analysis, hypothesis testing, and implementation steps to ensure robust fixes.
  • Reduces time wasted on symptom-focused patches and improves bug resolution reliability.
  • Real-world scenarios include test failures, production incidents, and flaky tests.

Quick Start

Load skills/debugging/systematic-debugging and begin Phase 1 to identify the root cause before proposing any 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 before attempting a fix?▼

To find a bug's root cause before fixing, apply a systematic debugging workflow enforcing root-cause investigation, pattern analysis, hypothesis testing, and implementation. This disciplined approach resists shortcuts and ensures robust, repeatable resolutions instead of symptom-focused patches.

What is the best way to stop guessing when debugging test failures or production incidents?▼

The best way to stop guessing during debugging is to follow a four-phase workflow that mandates pattern analysis and hypothesis testing before implementation. This method reduces time wasted on symptom-focused patches and improves bug resolution reliability for incidents and test failures.

How do I systematically debug flaky tests instead of applying random patches?▼

Systematically debug flaky tests by executing a phased root-cause investigation before proposing any fixes. Applying hypothesis testing and defensive patterns ensures you resolve the underlying failure rather than applying unreliable symptom-focused patches.

Does a systematic debugging approach work for complex production incidents?▼

Yes, a systematic debugging approach works for production incidents by enforcing a four-phase workflow of root-cause investigation, pattern analysis, hypothesis testing, and implementation. Guardrails resist shortcuts, ensuring robust and repeatable incident resolutions.

Why do my debugging fixes often fail to resolve the underlying failure?▼

Debugging fixes often fail because they target symptoms rather than root causes. By applying a disciplined workflow with pattern analysis and hypothesis testing before implementation, you ensure robust fixes and reduce time wasted on ineffective patches.

When should I use a systematic debugging workflow instead of quick patches?▼

Use a systematic debugging workflow instead of quick patches whenever you face test failures, production incidents, or flaky tests. It enforces root-cause investigation and hypothesis testing to ensure robust, repeatable resolutions rather than unreliable symptom-focused fixes.