systematic-debugging

Guide a four-phase process to identify root causes of software defects.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/olli107x/claude-code-starter-kit --skill systematic-debugging-olli107x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/olli107x/claude-code-starter-kit/tree/main/skills/development/testing/systematic-debugging
Command: npx skills add https://github.com/olli107x/claude-code-starter-kit --skill systematic-debugging-olli107x

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a structured, four-phase process to systematically identify and resolve the root cause of any bug, test failure, or unexpected behavior, preventing the common pitfalls of quick fixes and symptom treatment.

Core Features & Use Cases

  • Root Cause Mandate: Ensures that the underlying issue is always found before any fixes are implemented.
  • Four-Phase Framework: Guides users through Investigation, Pattern Analysis, Hypothesis Testing, and Implementation.
  • Pressure Resistance: Includes specific rules and language designed to prevent shortcuts under time pressure or when a quick fix seems obvious.
  • Use Case: When a test fails unexpectedly, instead of guessing or adding arbitrary delays, use this Skill to methodically trace the error back to its origin, ensuring a permanent fix and preventing future occurrences.

Quick Start

Use the systematic debugging skill to investigate any bug or test failure you encounter.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and how does it help with root cause analysis?

Systematic debugging is a structured methodology that mandates finding the root cause of software defects before implementing fixes. It prevents treating symptoms by enforcing evidence gathering, pattern analysis, and hypothesis testing to ensure permanent bug resolution.

How do I fix failing tests without guessing or applying quick fixes?

To fix failing tests without guessing, follow a four-phase process: investigate the failure, analyze patterns, test hypotheses, and create a failing test case. This ensures you trace the error to its origin and implement a permanent fix rather than a superficial patch.

What is the best way to troubleshoot production bugs under time pressure?

The best way to troubleshoot production bugs under time pressure is using a structured methodology with specific rules that prevent shortcuts. It enforces thorough investigation and hypothesis testing even when a quick fix seems obvious, ensuring the underlying issue is resolved.

How do I investigate performance problems and build errors methodically?

To investigate performance problems and build errors methodically, gather evidence and analyze patterns before implementing changes. This structured approach mandates creating failing test cases prior to fixes, ensuring the root cause of the unexpected behavior is identified.

Does this debugging methodology require any specific testing frameworks?

No specific testing frameworks are required. The methodology is framework-agnostic and focuses on the process of evidence gathering, pattern analysis, hypothesis testing, and creating failing test cases prior to implementation, making it applicable to any software engineering environment.

When should I avoid systematic debugging and just apply a patch?

You should never avoid systematic debugging for a patch. The methodology includes pressure resistance rules designed to prevent shortcuts even when a quick fix seems obvious, ensuring that symptom treatment and recurring bugs are always avoided.