systematic-debugging

Guide structured four-phase debugging with root cause analysis and hypothesis testing.

1|Updated Dec 23, 2024
One-click install
npx skills add https://github.com/Qualis/www-qual-is --skill systematic-debugging-qualis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Qualis/www-qual-is/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/Qualis/www-qual-is --skill systematic-debugging-qualis

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill prevents wasted time and new bugs by enforcing a rigorous, systematic approach to debugging, ensuring the root cause is identified before any fixes are attempted.

Core Features & Use Cases

  • Root Cause Investigation: Guides users through error messages, reproduction steps, and evidence gathering in multi-component systems.
  • Pattern Analysis: Helps identify similar working code and understand dependencies before proposing solutions.
  • Hypothesis Testing: Encourages forming and testing single, minimal hypotheses.
  • Defensive Programming: Promotes adding validation at multiple layers to make bugs impossible.
  • Use Case: When a CI build fails with an obscure error, this Skill ensures you don't just randomly change code, but systematically trace the failure to its origin, preventing future occurrences.

Quick Start

Use the systematic-debugging skill to investigate any bug, test failure, or unexpected behavior by following its four-phase process.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is the best way to find the root cause of a software bug instead of just fixing symptoms?

Root cause analysis is best achieved through a structured four-phase debugging process that emphasizes evidence gathering, pattern analysis, and hypothesis testing to ensure the underlying issue is fixed. This prevents wasted time and recurring defects.

How do I debug an obscure CI build failure systematically?

To debug a CI build failure systematically, follow a structured process of error investigation, reproduction, and data flow tracing to find the origin. This prevents randomly changing code and ensures you resolve the actual failure.

How do I trace data flow and errors in multi-component systems?

Tracing data flow in multi-component systems involves gathering evidence and using specific debugging techniques to track errors across dependencies. This structured approach ensures you understand interactions before attempting a fix.

When should I use a systematic debugging process for test failures?

You should use systematic debugging for test failures whenever you encounter unexpected behavior, obscure errors, or performance problems. It enforces rigorous investigation to identify the root cause before any code changes are attempted.

How can I prevent new bugs while fixing existing software defects?

To prevent new bugs while fixing software defects, employ defensive programming by adding validation at multiple layers. This makes bugs impossible to reintroduce and ensures your hypothesis testing focuses on single, minimal changes.