What happens if a fix doesn't work after multiple attempts?

If three or more fixes fail, the skill stops the process to question the underlying architecture, preventing further waste of time on fundamentally flawed patterns.

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

The Iron Law dictates that no fixes can be proposed until Phase 1 (Root Cause Investigation) is fully completed and the cause is understood.

How does this skill handle bugs in multi-layer systems?

It implements diagnostic instrumentation at every component boundary to log data entry/exit and state, identifying exactly where the failure occurs before investigating code.

Does this skill require Test-Driven Development?

Yes, Phase 4 requires creating a minimal failing test case before any fix is implemented to ensure the solution is verified and prevents regressions.

Systematic Debugging Framework

Name: Systematic Debugging Framework
Author: cipherstash

bycipherstash

•

Security & Testing

Implements a rigorous four-phase scientific framework to identify root causes and eliminate trial-and-error patching.

The Systematic Debugging skill transforms the debugging process from a series of guesses into a disciplined scientific method. It enforces a strict four-phase workflow—Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation—ensuring that every fix addresses the underlying issue rather than just masking symptoms. Ideal for complex multi-component systems and high-pressure environments, this skill helps developers avoid 'thrashing' by requiring consistent reproduction, evidence gathering through instrumentation, and architectural questioning when standard fixes fail.

Key Features

01Evidence-based root cause tracing and data flow analysis

02Strict four-phase debugging workflow enforcement

03Multi-layer diagnostic instrumentation for complex systems

04Pattern comparison against working reference implementations

05Automatic architectural review triggers after repeated fix failures

064 GitHub stars

Use Cases

01Resolving persistent bugs where previous 'quick fixes' have failed to stick

02Isolating failures in multi-component systems like CI/CD pipelines or microservices

03Establishing a stable reproduction path for intermittent or environmental issues

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cipherstash/cipherpowers systematic-debugging

For use in Claude.ai and ChatGPT

Download Skill