systematic-debugging

Trace software bugs and test failures to their root causes.

9|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/klh/speedy-claude --skill systematic-debugging-klh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/klh/speedy-claude/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/klh/speedy-claude --skill systematic-debugging-klh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a disciplined four-phase methodology to investigate, reproduce, and resolve software bugs and test failures so fixes address root causes rather than symptoms.

Core Features & Use Cases

  • Root Cause Investigation: Reproduce issues, read full error messages, collect logs, and trace the call chain to the original trigger.
  • Pattern Analysis: Compare failing implementations with working examples and identify dependency or assumption differences.
  • Hypothesis-driven Testing: Formulate one clear hypothesis, design a minimal test, and iterate until the cause is confirmed.
  • Implementation Guardrails: Create failing tests, implement a minimal fix that targets the root cause, run the full suite, and stop if multiple fixes fail.
  • Use Case: Diagnose flaky CI test failures, trace runtime exceptions to their origin, or perform git bisect to find breaking commits.

Quick Start

Use the systematic-debugging skill to reproduce the failure, trace the upstream cause, create a minimal failing test, and propose a single root-cause 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 failing test in my CI pipeline?

To find the root cause of a failing test, you reproduce the issue, collect logs, and trace the call chain back to the original trigger. This hypothesis-driven approach ensures fixes target the underlying defect rather than just masking symptoms.

What is the best way to debug an intermittent or flaky test failure?

The best way to debug an intermittent flaky test failure is using a systematic four-phase methodology to reproduce the issue and analyze patterns. By comparing failing implementations with working examples, you can identify dependency or assumption differences causing the inconsistency.

How do I use git bisect to find a regression in my codebase?

To use git bisect for finding a regression, you apply hypothesis-driven testing against your version history to compare breaking commits. This systematic approach isolates the exact commit introducing the runtime error or test failure.

What do I need to trace a runtime exception to its origin effectively?

To trace a runtime exception to its origin, you need reproducible failure logs, access to the source code, and the ability to run targeted tests. These inputs allow you to formulate a clear hypothesis and design a minimal test to confirm the cause.

When should I stop attempting fixes during root-cause analysis?

You should stop attempting fixes during root-cause analysis if multiple fixes fail to resolve the issue. The methodology advises implementing a single minimal fix targeting the root cause, running the full suite, and halting if repeated fixes fail.