systematic-debugging

Guide engineers through a four-phase root-cause debugging workflow.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Avi977/ace-claude-toolkit --skill systematic-debugging-avi977
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Avi977/ace-claude-toolkit/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/Avi977/ace-claude-toolkit --skill systematic-debugging-avi977

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging prevents wasted time by enforcing root-cause analysis before patching, leading to faster, more reliable issue resolution.

Core Features & Use Cases

  • Phase-driven workflow: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation guide teams through a disciplined debugging cycle.
  • Comprehensive evidence gathering: read error messages, reproduce reliably, trace data flow, and compare against references to identify the failing component.
  • Real-world applicability: fixes production bugs, flaky tests, and performance degradation by isolating root causes and validating with minimal changes.

Quick Start

Begin Phase 1 by reproducing the issue, reading error messages, and collecting diagnostic evidence before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and when should I use root-cause analysis?

Systematic debugging is a disciplined workflow enforcing root-cause analysis before applying fixes. Use it to resolve production bugs, test failures, and performance degradation across multi-component software systems reliably.

How do I debug production issues using a phase-driven workflow?

Debug production issues by following a four-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. Start by reproducing the issue and collecting diagnostic evidence before proposing fixes.

Can I trace data flow to fix flaky tests in multi-component systems?

Yes, you can fix flaky tests by tracing data flow and comparing against references to isolate failing components. Comprehensive evidence gathering ensures you identify root causes and validate with minimal changes.

What's the best way to find root causes of software bugs without patching prematurely?

The best way to find root causes is enforcing evidence collection and pattern analysis before implementation. Read error messages, reproduce reliably, and form tested hypotheses to prevent wasted time on premature patches.

Does systematic debugging work for performance degradation and complex software bugs?

Yes, systematic debugging applies to performance degradation and complex bugs by isolating root causes across multi-component systems. It guides teams through evidence gathering and guarded fixes for faster, reliable issue resolution.

Why should I not fix bugs immediately and what are the limitations of ad-hoc debugging?

Ad-hoc debugging risks patching symptoms instead of root causes, leading to wasted time and recurring issues. Systematic debugging prevents this by enforcing evidence collection, data-flow tracing, and hypothesis testing before implementation.