systematic-debugging

Investigate software bugs and test failures to determine root causes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/withmartian-sandbox-darkside/ghrc-y-3126672651424eddb640ecc81321a665 --skill systematic-debugging-withmartian-sandbox-darkside
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/withmartian-sandbox-darkside/ghrc-y-3126672651424eddb640ecc81321a665/tree/main/default/skills/systematic-debugging
Command: npx skills add https://github.com/withmartian-sandbox-darkside/ghrc-y-3126672651424eddb640ecc81321a665 --skill systematic-debugging-withmartian-sandbox-darkside

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents guesswork and ineffective fixes by forcing a structured investigation of test failures, runtime errors, and unexpected behavior so teams fix the true root cause rather than symptoms.

Core Features & Use Cases

  • Four-phase framework: Root cause investigation, pattern analysis, hypothesis testing, and implementation with clear exit criteria.
  • Safety guardrails: Timeboxes, circuit breakers (3 failed hypotheses or fixes), and mandatory evidence collection to avoid wasted work and unsafe patching.
  • Practical use cases: Reproducing intermittent production errors, diagnosing failing CI tests, tracing data-origin issues across services, and guiding minimal-change fixes backed by failing tests.

Quick Start

Use systematic-debugging to investigate a failing test by reproducing the error, tracing data flow to the origin, and testing a single minimal hypothesis.

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 failing CI test instead of just patching symptoms?

To find the root cause of a failing CI test, reproduce the error, trace data flow to its origin, and test a single minimal hypothesis using a structured four-phase investigation framework to ensure the true cause is fixed.

What is the best way to debug intermittent production errors with unknown causes?

The best way to debug intermittent production errors is applying systematic root cause investigation, which requires reproducible failure steps, log analysis, and evidence collection to determine the exact trigger.

How do I stop guessing and structure my debugging process for runtime errors?

Structure your debugging process for runtime errors using a four-phase framework: root cause investigation, pattern analysis, hypothesis testing, and implementation, backed by mandatory evidence collection.

Does systematic debugging work without reproducible failure steps and code history access?

Systematic debugging does not work well without reproducible failure steps, access to logs, and code history, as these are required to run minimal hypothesis tests and create failing unit tests.

What should I do if my bug fixes keep failing or my hypotheses are wrong?

If your bug fixes keep failing or hypotheses are wrong, trigger circuit breakers after 3 failed attempts, enforce timeboxing, and collect more evidence before attempting another minimal-change fix.