systematic-debugging

Guide structured four-phase debugging to identify root causes.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/yasuwrldhyper/ai-skills-collection --skill systematic-debugging-yasuwrldhyper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/yasuwrldhyper/ai-skills-collection/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/yasuwrldhyper/ai-skills-collection --skill systematic-debugging-yasuwrldhyper

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 caused by quick fixes that only address symptoms rather than the underlying root cause of a problem.

Core Features & Use Cases

  • Structured Investigation: Guides you through a mandatory 4-phase process (Investigation, Pattern Analysis, Hypothesis, Implementation) to ensure thorough root cause analysis.
  • Pressure Resistance: Includes explicit rules and language designed to counteract the temptation to take shortcuts under time pressure or when a quick fix seems obvious.
  • Use Case: When a critical bug appears in production, instead of immediately trying a known "quick fix" that might mask the real issue, you load this skill to systematically uncover and address the true root cause, preventing future occurrences.

Quick Start

Use the systematic-debugging skill to investigate any bug or unexpected behavior before attempting any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of a bug instead of just fixing the symptoms?

To find the root cause of a bug, use a structured four-phase methodology: Investigation, Pattern Analysis, Hypothesis, and Implementation. This systematic debugging process ensures you uncover the underlying issue rather than applying a quick fix that only masks symptoms.

What is the best way to troubleshoot a critical production bug systematically?

The best way to troubleshoot a critical production bug systematically is to follow a strict four-phase process: investigate the issue, analyze patterns, form a hypothesis, and implement the fix. This prevents hasty patches under time pressure and ensures true root cause resolution.

How do I stop developers from taking shortcuts when debugging under time pressure?

To stop developers from taking shortcuts when debugging under time pressure, apply explicit rules that resist rationalizations and mandate a structured investigation process. This enforces thorough pattern analysis and hypothesis formation before any implementation begins.

When should I use a systematic debugging process for troubleshooting software issues?

You should use a systematic debugging process for troubleshooting software issues whenever a critical bug appears or unexpected behavior occurs. It is applicable to all software development and operational scenarios to prevent wasted time and new bugs from symptom-fixing.

What are the four phases of systematic debugging for root cause analysis?

The four phases of systematic debugging for root cause analysis are Investigation, Pattern Analysis, Hypothesis, and Implementation. This structured methodology guides you through uncovering the true root cause before attempting any code fixes.