systematic-debugging

Identify and resolve root causes of software bugs through a four-phase methodology.

Updated May 5, 2026
One-click install
npx skills add https://github.com/iani-kuli/harness_bro --skill systematic-debugging-iani-kuli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/iani-kuli/harness_bro/tree/main/.claude/skills/curated/systematic-debugging
Command: npx skills add https://github.com/iani-kuli/harness_bro --skill systematic-debugging-iani-kuli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill prevents the common trap of applying random, ineffective patches to software bugs, which often masks symptoms while creating new issues.

Core Features & Use Cases

  • Four-Phase Framework: Guides you through investigation, pattern analysis, hypothesis testing, and implementation.
  • Anti-Pattern Detection: Explicitly identifies and stops you from using shortcuts like guessing or fixing symptoms.
  • Use Case: When a production service experiences intermittent failures, use this skill to trace the root cause through multiple system layers instead of just restarting the service.

Quick Start

Load the systematic debugging skill to begin a rigorous investigation of the current test failure.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic approach to debugging complex software bugs?

Systematic debugging provides a rigorous, four-phase methodology for identifying and resolving software bugs, guiding you through investigation, pattern analysis, hypothesis testing, and implementation to target the actual root cause.

How do I find the root cause of intermittent production failures?

To find the root cause of intermittent production failures, apply a structured debugging methodology to trace evidence through multiple system layers, form hypotheses, and test them rather than restarting services or applying symptom-based patches.

What is the best way to stop developers from patching bug symptoms instead of root causes?

The best way to stop symptom patching is to enforce a systematic debugging framework that detects anti-patterns like guessing and explicitly blocks shortcuts, requiring evidence-based investigation and defense-in-depth validation before implementation.

Can I use systematic debugging for performance issues and integration errors?

Yes, you can use systematic debugging for performance issues and integration errors, as the methodology applies to complex system debugging where symptom-based patching is insufficient for resolving the underlying failure.

How do I test debugging hypotheses for complex system failures?

You test debugging hypotheses by adhering to a four-phase methodology that isolates variables through evidence-based investigation and pattern analysis, validating your root cause theory with defense-in-depth principles before implementing a fix.

When should I avoid symptom-based patching for test failures?

You should avoid symptom-based patching whenever a test failure involves complex system interactions, intermittent issues, or integration errors, as masking symptoms often creates new issues while leaving the actual root cause unresolved.