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

The Iron Law states that no fixes can be proposed or implemented without first completing a full root cause investigation based on observable evidence.

How does this skill handle multi-layer system failures?

It uses diagnostic instrumentation to log data at every component boundary, allowing the AI to see exactly where the data enters, transforms, or breaks between layers.

Does this skill require writing automated tests?

Yes, Phase 4 of the workflow requires creating a failing test case—either in a framework or as a standalone script—before the fix is finalized.

When should I use the debugging-patterns skill?

Use it for any technical issue, but it is especially critical for complex bugs, multi-component failures, or when 'quick fixes' have already failed to resolve the problem.

What happens if several fixes fail to work?

If three or more fix attempts fail, the skill mandates an architectural review to determine if the underlying pattern is fundamentally flawed rather than just bugged.

Systematic Debugging Patterns

Name: Systematic Debugging Patterns
Author: romiluz13

byromiluz13

•

Security & Testing

Enforces a rigorous, evidence-based debugging workflow to identify root causes before implementing code fixes.

The Systematic Debugging Patterns skill transforms Claude Code into a disciplined bug investigator by enforcing the 'Iron Law': no code changes until a root cause is proven. It guides the AI through four distinct phases—Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation—preventing common pitfalls like 'guess-and-check' fixes or symptom-masking. Especially effective for complex, multi-component systems, this skill ensures that fixes are robust, tested, and architecturally sound, significantly reducing time spent on trial-and-error debugging.

Key Features

0118 GitHub stars

02Enforces a mandatory 'Root Cause First' investigation protocol.

03Detects and prevents AI 'thrashing' by stopping after multiple failed fix attempts.

04Requires the creation of a failing test case before any permanent fix is applied.

05Implements a 'LOG FIRST' approach for evidence gathering across components.

06Provides structured diagnostic patterns for tracing data flow through API and service boundaries.

Use Cases

01Resolving recurring regression bugs where previous 'quick fixes' have failed to address the underlying issue.

02Debugging data flow issues across multiple service boundaries or microservices.

03Investigating intermittent test failures or race conditions in complex CI/CD pipelines.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add romiluz13/cc10x debugging-patterns

For use in Claude.ai and ChatGPT

Download Skill