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.