systematic-debugging

Guide engineers through four phases to identify and resolve bugs.

31|3|Updated Dec 12, 2025
One-click install
npx skills add https://github.com/JeremyDev87/codingbuddy --skill systematic-debugging-jeremydev87
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/JeremyDev87/codingbuddy/tree/main/packages/rules/.ai-rules/skills/systematic-debugging
Command: npx skills add https://github.com/JeremyDev87/codingbuddy --skill systematic-debugging-jeremydev87

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes waste time and create new bugs. A disciplined approach that prioritizes root-cause investigation before proposing fixes dramatically reduces rework and regression risk.

Core Features & Use Cases

  • Phase-driven debugging: Enforces Phase 1 through Phase 4 to identify root causes before changes.
  • Diagnostic instrumentation & evidence gathering: Collects data at each component boundary to isolate failures.
  • Pattern analysis & hypothesis testing: Compares against references, forms testable hypotheses, and validates them with minimal changes.
  • Defensive practices: Includes defense-in-depth and traceability techniques to prevent recurrence. Use Case: When facing a bug, test failure, or unexpected behavior, follow the four phases to systematically identify root causes and craft robust fixes.

Quick Start

Follow the four phases to identify root causes before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and how does it find root causes?

Systematic debugging is a disciplined, phase-driven approach to trace and resolve bugs. It enforces evidence gathering and hypothesis testing across four phases to isolate failures and identify root causes before any code changes are proposed.

How do I debug a production bug without causing regressions?

To debug a production bug safely, follow a structured phase-driven debugging process that prioritizes root-cause investigation. It uses diagnostic instrumentation and defensive practices like defense-in-depth to ensure fixes resolve the actual issue without introducing new regressions.

What's the best way to debug test failures and integration breakages?

The best way to debug test failures and integration breakages is applying systematic debugging. It guides you through pattern analysis, comparing against references, and forming testable hypotheses validated with minimal changes to isolate the exact component boundary failure.

When should I use a systematic approach instead of trial-and-error debugging?

Use a systematic debugging approach when random fixes waste time or create new bugs. If you face complex production bugs or performance problems requiring root-cause investigation, this method prevents rework and reduces regression risk through structured evidence gathering.

Does systematic debugging work for performance problems and tracing issues?

Yes, systematic debugging works for performance problems by applying diagnostic instrumentation and tracing at component boundaries. It collects data to form testable hypotheses, ensuring you accurately isolate the root cause of the performance degradation before implementing fixes.