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

The Iron Law states that no fixes can be proposed until a Root Cause Investigation is completed and the underlying issue is fully understood through evidence.

How does this skill handle complex multi-component systems?

It implements diagnostic instrumentation at every component boundary to log input/output and state, identifying exactly where data flow breaks before investigating specific components.

Does this skill require other plugins?

While it functions independently, it is designed to work synergistically with root-cause-tracing and test-driven-development skills for maximum effectiveness.

What happens if three fix attempts fail?

The skill identifies a likely architectural flaw and triggers a pause to question the fundamental design with the human partner rather than attempting a fourth symptomatic fix.

Why use a framework for seemingly simple bugs?

Systematic debugging is often faster than 'guess-and-check' even for simple bugs because it ensures the first fix attempt is correct and doesn't introduce side effects.

Systematic Debugging Framework

Name: Systematic Debugging Framework
Author: NickCrew

byNickCrew

•

安全与测试

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

This skill equips Claude with a structured, scientific approach to technical troubleshooting, ensuring that every bug, test failure, or performance issue is fully understood before a fix is proposed. By moving through distinct phases of root cause investigation, pattern analysis, and hypothesis testing, it prevents the common pitfalls of 'guess-and-check' coding, reduces the risk of regression, and identifies when underlying architectural flaws require attention rather than simple patches. It is specifically designed to stop 'thrashing' during high-pressure environments by enforcing an evidence-based resolution process.

主要功能

01Mandatory architectural review triggers after three failed fix attempts

02Four-phase scientific debugging framework (Investigation, Analysis, Testing, Implementation)

03Multi-component diagnostic instrumentation for complex system failures

047 GitHub stars

05Integration with Root Cause Tracing and Test-Driven Development (TDD) methodologies

06Iron Law enforcement: No fixes allowed until the root cause is verified

使用场景

01Investigating deep-stack errors in complex multi-component systems

02Resolving recurring bugs where previous fix attempts have failed or caused regressions

03Debugging intermittent production bugs or inconsistent test failures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nickcrew/claude-cortex systematic-debugging

For use in Claude.ai and ChatGPT

Download Skill