How does the skill handle bugs that keep coming back?

If three fix attempts fail, the skill automatically triggers an architectural review to determine if the issue is a design flaw rather than a simple implementation bug.

What is the Systematic Debugging skill for Claude Code?

It is a specialized capability that guides Claude through a structured, four-phase process to identify and resolve bugs scientifically rather than through guesswork or random patches.

What is the 'Iron Law' of this debugging skill?

The Iron Law states that no fixes can be proposed or implemented until a full Phase 1 Root Cause Investigation is completed and the source of the error is found.

When should I use this skill instead of a standard fix?

You should use it for any technical issue, especially when under time pressure, when previous fixes have failed, or when dealing with complex multi-component systems.

Systematic Debugging Framework

Name: Systematic Debugging Framework
Author: samjhecht

bysamjhecht

•

セキュリティとテスト

Eliminates trial-and-error fixing by enforcing a rigorous four-phase root cause analysis and debugging process.

The Systematic Debugging skill transforms Claude's troubleshooting approach from guesswork into a scientific methodology. By mandating a four-phase framework—Investigation, Analysis, Hypothesis Testing, and Implementation—it ensures that every fix targets the actual root cause rather than just a symptom. This skill is particularly valuable for complex, multi-component systems where data flow is obscured and for situations where previous quick-fix attempts have failed, helping developers maintain high code quality and architectural integrity through the 'Iron Law' of debugging.

主な機能

01Enforces a mandatory four-phase scientific debugging framework

021 GitHub stars

03Detects architectural flaws versus implementation bugs automatically

04Triggers mandatory architectural reviews after three failed fix attempts

05Requires diagnostic instrumentation for multi-layer system investigation

06Mandates minimal hypothesis testing to verify causes before fixing

ユースケース

01Evaluating if recurring bugs require an architectural refactor or simple fix

02Diagnosing persistent test regressions, race conditions, and edge cases

03Troubleshooting complex failures in distributed or multi-layered systems

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add samjhecht/wrangler systematic-debugging

For use in Claude.ai and ChatGPT

Download Skill