systematic-debugging

Identify root causes of bugs using a four-phase debugging framework.

1|Updated Jan 5, 2023
One-click install
npx skills add https://github.com/riez/dots --skill systematic-debugging-riez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/riez/dots/tree/main/.config/agentic/skills/systematic-debugging
Command: npx skills add https://github.com/riez/dots --skill systematic-debugging-riez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you identify and fix root causes of bugs using a structured four-phase framework, avoiding symptom fixes.

Core Features & Use Cases

  • Phase-driven debugging with explicit Phase 1 root-cause investigation, Phase 2 pattern analysis, Phase 3 hypothesis testing, and Phase 4 implementation.
  • Anti-pattern awareness: Includes practical guidance to resist time-pressure shortcuts.
  • Defense-in-depth mindset: Encourages you to add validations across multiple layers to prevent recurrence.

Quick Start

Follow Phase 1 to start root-cause investigation before attempting any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging framework for identifying root causes?

A systematic debugging framework identifies root causes of bugs by completing four distinct phases: root-cause investigation, pattern analysis, hypothesis testing, and implementation. This structured approach prevents symptom fixes and ensures thorough technical issue resolution.

How do I debug test failures and production bugs step by step?

Debug test failures and production bugs step by step by following a four-phase process: exhaust Phase 1 root-cause investigation before coding any fix, analyze patterns in Phase 2, test hypotheses in Phase 3, and implement the validated fix in Phase 4.

Why do my bug fixes only address symptoms instead of the root cause?

Bug fixes often address symptoms instead of the root cause when time-pressure shortcuts bypass Phase 1 investigation. Applying a systematic debugging framework with explicit guardrails and anti-pattern awareness resists these shortcuts and ensures true root-cause resolution.

When should I use a defense-in-depth approach to prevent recurring integration bugs?

Use a defense-in-depth approach to prevent recurring integration bugs when you need multiple validation layers across your system. This mindset adds safeguards throughout the architecture, preventing technical issues from recurring after the initial root-cause fix.

What's the best way to stop time-pressure shortcuts during root-cause analysis?

The best way to stop time-pressure shortcuts during root-cause analysis is to enforce a four-phase systematic debugging framework. Built-in guardrails and anti-pattern awareness explicitly require completing Phase 1 investigation before allowing any code fixes.

Does systematic debugging work for all technical issues or only specific software engineering problems?

Systematic debugging works for all technical issues, including test failures, production bugs, and integration problems. The four-phase framework applies universally to any software engineering context requiring root-cause identification and structured resolution.