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.