systematic-debugging

Guide root-cause investigation across multi-component systems with structured phases and scoring.

29|5|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/johnqtcg/awesome-skills --skill systematic-debugging-johnqtcg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/johnqtcg/awesome-skills/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/johnqtcg/awesome-skills --skill systematic-debugging-johnqtcg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Systematic Debugging provides a disciplined approach to debugging across code, tests, and production incidents, ensuring root-cause investigation happens before fixes and that evidence supports every conclusion.

Core Features & Use Cases

  • Root-cause identification across multi-component systems
  • Evidence gathering, traceability, and hypothesis discipline
  • Four-phase workflow (Phase 1–Phase 4) with clear gates and scorecard usage

Quick Start

Copy the skill into your Claude Code project and follow the Phase 1–Phase 4 workflow to perform a structured RCA.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic approach to debugging complex multi-component systems?

Systematic debugging replaces guesswork with a four-phase workflow that enforces evidence collection, hypothesis discipline, and clear gates to ensure root-cause identification before applying fixes.

How do I find the root cause of flaky tests using a structured debugging workflow?

You can resolve flaky tests by applying boundary instrumentation and evidence gathering within a structured four-phase workflow, using a standardized scorecard to evaluate and validate each hypothesis.

How do I conduct root-cause analysis for production incidents without guessing?

Root-cause analysis for production incidents uses evidence collection and hypothesis discipline across four gated phases, ensuring every conclusion is supported by traceable evidence before applying fixes.

When should I use a phased debugging methodology instead of standard troubleshooting?

A phased debugging methodology is necessary for hard-to-trace bugs in multi-component systems where standard troubleshooting fails, requiring strict evidence collection, hypothesis discipline, and scorecard evaluation.

Can I apply systematic debugging to both code defects and production incidents?

Yes, systematic debugging applies to both code defects and production incidents, providing a disciplined approach that ensures evidence supports every conclusion across tests, code, and live systems.

What are the limitations of using a scorecard-based debugging workflow?

The scorecard-based workflow requires strict adherence to evidence collection and phased gates, which may introduce overhead for simple, easily reproducible bugs that do not need systematic root-cause investigation.