systematic-debugging

Identify software bug root causes through a four-phase evidence-based investigation process.

2|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon-framework --skill systematic-debugging-krzemienski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/krzemienski/shannon-framework/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill systematic-debugging-krzemienski

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A four-phase debugging framework to ensure understanding and evidence-based fixes rather than quick patches.

Core Features & Use Cases

  • Phase 1: Root cause investigation
  • Phase 2: Pattern analysis
  • Phase 3: Hypothesis testing
  • Phase 4: Implementation after evidence

Quick Start

Initiate systematic debugging before proposing any fix.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify the root cause of a bug instead of applying quick fixes?

Root-cause debugging follows a four-phase process: investigate the failure systematically, analyze patterns in the evidence, test hypotheses with instrumentation, then implement fixes based on findings. This approach prevents patches that mask underlying problems and recur later.

What's the best way to debug test failures and production issues?

Systematic debugging applies the same disciplined investigation across test failures, production bugs, unexpected behavior, and performance issues. Collect explicit evidence through instrumentation before proposing changes, ensuring fixes address the actual root cause rather than symptoms.

When should I use a structured debugging framework instead of ad-hoc troubleshooting?

Use structured debugging when facing complex failures, intermittent bugs, or issues that recur after attempted fixes. The four-phase framework prevents wasted effort on misdiagnosed problems and reduces time spent on ineffective patches.

How do I know when I've found the actual root cause versus a symptom?

Root-cause investigation and pattern analysis phases enforce evidence collection and hypothesis testing before implementation. A true root cause explains all observed symptoms consistently and, when fixed, resolves the issue without reappearance.

Can I apply systematic debugging to build and integration problems?

Yes. Systematic debugging handles build failures and integration problems alongside test failures and production bugs. The same four-phase investigation—instrumentation, pattern analysis, hypothesis testing, implementation—works across the full spectrum of software failures.