systematic-debugging

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

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/OnClickListener2048/confluence-mcp --skill systematic-debugging-onclicklistener2048
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/OnClickListener2048/confluence-mcp/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/OnClickListener2048/confluence-mcp --skill systematic-debugging-onclicklistener2048

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When debugging complex issues, this skill guides you to stop guessing and follow a disciplined 4-phase process to identify the real root cause before proposing fixes.

Core Features & Use Cases

  • Four-phase systematic debugging workflow: root-cause investigation, pattern analysis, hypothesis testing, and implementation.
  • Built-in safeguards: never fix symptoms first, require evidence, and use defensive checks to prevent regression.
  • Practical scenarios: handling production incidents, flaky tests, and multi-service failures with traceable steps and documentation.

Quick Start

Begin with Phase 1 (root-cause investigation) and sequentially complete Phases 2–4 to identify the root cause and implement a robust 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 production incident without just guessing fixes?

To find the root cause of a production incident, follow a structured four-phase workflow that enforces disciplined investigation and requires explicit evidence before proposing or implementing any fixes.

What is the best way to debug flaky tests in a multi-service architecture?

The best way to debug flaky tests in a multi-service architecture is using a systematic process of pattern analysis and hypothesis testing, ensuring you isolate the actual failure point with traceable evidence.

How does a systematic debugging workflow prevent regression when fixing software bugs?

A systematic debugging workflow prevents regression by enforcing defense-in-depth checks and validating your hypothesis with explicit evidence before allowing any code modifications.

Can I use this approach to troubleshoot complex multi-service failures?

Yes, you can use this approach to troubleshoot complex multi-service failures, as the workflow specifically covers isolating root causes across distributed services with traceable documentation.

When should I not apply a symptom-first approach to resolving software bugs?

You should never apply a symptom-first approach when resolving software bugs, as this systematic method explicitly requires identifying and isolating the actual root cause before attempting any fix.

What are the steps to systematically debug a complex software failure?

The steps to systematically debug a complex software failure involve sequentially completing four phases: root-cause investigation, pattern analysis, hypothesis testing, and validated implementation.