systematic-debugging

Enforce a four-phase debugging process to identify root causes before fixes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/bjconlan/burndown --skill systematic-debugging-bjconlan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/bjconlan/burndown/tree/main/.gemini/skills/systematic-debugging
Command: npx skills add https://github.com/bjconlan/burndown --skill systematic-debugging-bjconlan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a disciplined, repeatable process to uncover root causes before applying fixes, preventing symptom-focused patches and wasted effort.

Core Features & Use Cases

  • Four-phase framework (Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation) as the core workflow
  • Anti-patterns and defense-in-depth guidance to resist shortcuts under pressure
  • References to supporting techniques (root-cause tracing, defense-in-depth, condition-based waiting) and example scenarios

Quick Start

Follow Phase 1 before proposing any fix to ensure root-cause identification prior to change

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a root-cause debugging process for software bugs and production incidents?▼

You debug systematically by following four sequential phases: root cause investigation, pattern analysis, hypothesis testing, and implementation, enforcing root-cause validation before making any code changes.

How do I stop fixing symptoms and find the actual root cause of test failures?▼

To stop fixing symptoms, enforce a root cause investigation phase before applying any changes, using defense-in-depth guidance and anti-pattern defenses to resist shortcuts under pressure and prevent wasted effort.

Can I use this systematic debugging method for performance and integration problems?▼

Yes, this systematic debugging method applies to performance issues, integration problems, production incidents, and test failures across diverse systems by enforcing a consistent four-phase root-cause analysis workflow.

What is the best way to debug production incidents without taking shortcuts?▼

The best way to debug production incidents without shortcuts is to enforce a four-phase debugging process with anti-pattern defenses and layered validation, ensuring robust root-cause analysis before any implementation.

Why does my debugging process fail to prevent recurring bugs across diverse systems?▼

Your debugging process fails to prevent recurring bugs if it lacks a disciplined four-phase framework and anti-pattern defenses, leading to symptom-focused patches instead of identifying and resolving the actual root cause.