systematic-debugging

Diagnose software bug root causes through a four-phase investigation process.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ForeverWorld/curdx-ralph --skill systematic-debugging-foreverworld
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/ForeverWorld/curdx-ralph/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/ForeverWorld/curdx-ralph --skill systematic-debugging-foreverworld

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging enforces a disciplined, evidence-driven process to diagnose bugs, test failures, and unexpected behavior so fixes target root causes instead of symptoms. It prevents wasted effort from repeated, ad-hoc fixes and reduces the risk of introducing new regressions.

Core Features & Use Cases

  • Four-phase workflow: Root cause investigation, pattern analysis, hypothesis testing, and implementation with clear gates between phases.
  • Multi-component instrumentation: Guidance for adding diagnostics at component boundaries to localize failures across CI, services, and build systems.
  • Test-driven fixes and escalation: Always create a failing test, apply a single minimal fix, verify safety, and escalate when multiple fixes fail.
  • Use Case: Reproduce a flaky CI failure, trace the failing data flow across workflow and build layers, form a minimal hypothesis, write a failing test, and implement the verified fix.

Quick Start

Reproduce the failure reliably, gather layered evidence across components, form a single hypothesis, test minimally with a failing test case, and then implement the 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 flaky CI test failures and unexpected software behavior?▼

To find the root cause of flaky CI failures, reproduce the failure reliably, gather layered evidence across components, form a single hypothesis, write a failing test, and apply a minimal fix. This evidence-driven workflow prevents treating symptoms as root causes.

What is the best way to debug failures across multi-component services and build pipelines?▼

The best way to debug multi-component services is adding instrumentation at component boundaries to localize failures across CI, services, and build systems, then following a four-phase process of investigation, pattern analysis, hypothesis testing, and test-driven implementation.

How do I stop repeatedly fixing bug symptoms instead of resolving the underlying software defect?▼

Stop fixing bug symptoms by enforcing a disciplined debugging workflow with clear gates: investigate root causes, analyze patterns, test a single hypothesis minimally with a failing test case, and implement one verified fix before moving forward.

When should I escalate a bugfix if my initial fixes are not resolving the production incident?▼

You should escalate a bugfix during a production incident when multiple minimal fixes fail to resolve the issue. The systematic debugging process includes clear escalation criteria to trigger when repeated, ad-hoc fixes do not address the root cause.

Does systematic debugging work for tracing data flow across workflow and build layers?▼

Yes, systematic debugging works for tracing failing data flow across workflow and build layers by applying multi-component instrumentation to gather evidence, forming a minimal hypothesis, and verifying the fix with a test-driven implementation.

Why do I need a failing test case before applying a bugfix?▼

You need a failing test case before applying a bugfix to verify the root cause is isolated and ensure the fix targets the actual defect. This test-driven approach confirms the fix works and prevents introducing new regressions.