systematic-debugging

Trace root causes of bugs and failures before applying verified fixes.

Updated Dec 22, 2025
One-click install
npx skills add https://github.com/acho1833/spreadline2 --skill systematic-debugging-acho1833
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/acho1833/spreadline2/tree/main/.claude/commands/systematic-debugging
Command: npx skills add https://github.com/acho1833/spreadline2 --skill systematic-debugging-acho1833

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you debug bugs, test failures, performance issues, and unexpected behavior without wasting time on random fixes or symptom patches. It is designed to keep you focused on root cause investigation, even when you are under pressure or tempted to guess.

Core Features & Use Cases

  • Root Cause Investigation: Read errors carefully, reproduce the issue, check recent changes, and trace data flow before changing code.
  • Pattern Analysis and Hypothesis Testing: Compare against working examples, form one clear hypothesis, and test the smallest possible change.
  • Safe Implementation Discipline: Create failing tests first, fix one thing at a time, verify the result, and stop to re-analyze if the first fix fails.
  • Use Case: A flaky test keeps failing intermittently in CI; this Skill guides you to inspect the failure pattern, identify the real cause, and apply a minimal fix that prevents recurrence.

Quick Start

Use the systematic-debugging skill to investigate this bug from the root cause and propose the smallest verified 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 flaky test instead of just patching symptoms?

To find the root cause of a flaky test, you need to inspect the failure pattern, reproduce the issue, and trace data flow before changing code. This approach ensures you apply a minimal fix that prevents recurrence rather than masking the symptom.

What is the best way to debug production incidents without making random fixes?

Debugging production incidents requires disciplined investigation: read errors carefully, check recent changes, form a single hypothesis, and test the smallest possible change. This method keeps you focused on verified root-cause fixes instead of guessing under pressure.

How do I fix build failures by tracing the root cause before changing code?

Fixing build failures by tracing root causes involves reading errors carefully, reproducing the issue, and comparing against working examples. You create a failing test first, fix one thing at a time, and verify the result to ensure the actual problem is resolved.

Can I use systematic hypothesis testing for performance regressions and integration problems?

Yes, systematic hypothesis testing applies to performance regressions and integration problems. You gather evidence, compare patterns against working examples, and test a single clear hypothesis with the smallest possible change to verify the root cause.

What should I do when my first fix for a bug fails to resolve the issue?

When your first fix fails, you should stop and re-analyze the problem. Safe implementation discipline requires creating failing tests first, fixing one thing at a time, and verifying results, which prompts you to gather more evidence if the initial hypothesis is wrong.

Does systematic debugging work for intermittent CI failures and unexpected behavior?

Yes, systematic debugging works for intermittent CI failures and unexpected behavior. It guides you to inspect failure patterns, identify the real cause through evidence gathering, and apply a minimal verified fix that prevents recurrence.