systematic-debugging

Guide engineers through a four-phase root-cause investigation before applying fixes.

Updated Jan 3, 2026
One-click install
npx skills add https://github.com/jayhjenkins/Dev-Team-Full-SDLC --skill systematic-debugging-jayhjenkins
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/jayhjenkins/Dev-Team-Full-SDLC/tree/main/vendor/superpowers/skills/systematic-debugging
Command: npx skills add https://github.com/jayhjenkins/Dev-Team-Full-SDLC --skill systematic-debugging-jayhjenkins

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined, phase-driven approach to diagnosing bugs, preventing symptom-focused fixes, and accelerating durable resolutions.

Core Features & Use Cases

  • Four-phase framework: Root-cause investigation, pattern analysis, hypothesis testing, and implementation with explicit success criteria.
  • Defense-in-depth: Validations at multiple layers to prevent regressions and ensure robust fixes.
  • Root-cause tracing: Backward tracing from symptoms to original trigger, with instrumentation recommendations.
  • When to use: Ideal for production incidents, flaky tests, or complex debugging scenarios where speed and correctness matter.

Quick Start

Load this skill and follow the Phase 1 Root Cause Investigation checklist before proposing any fixes, then progressively work through Phases 2–4 to validate and ship a durable solution.

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 before applying a fix?▼

To find a root cause before fixing, follow a four-phase systematic debugging workflow that enforces non-skippable root-cause investigation, backward tracing from symptoms to triggers, and hypothesis testing.

What is the best way to debug production incidents and flaky tests?▼

The best way to debug production incidents and flaky tests is using a phase-driven framework that applies root-cause tracing and defense-in-depth validations to ensure durable resolutions and prevent regressions.

How does systematic debugging prevent symptom-focused fixes?▼

Systematic debugging prevents symptom-focused fixes by mandating a Phase 1 root-cause investigation checklist, requiring pattern analysis, hypothesis testing, and explicit success criteria before implementation.

When do I need defense-in-depth validations for debugging?▼

You need defense-in-depth validations during the implementation phase of debugging to add multi-layered checks that prevent future regressions and ensure robust fixes across complex integrations.

Can I use root-cause tracing for complex integration debugging scenarios?▼

Yes, root-cause tracing is ideal for complex integration debugging scenarios, using backward tracing from symptoms to the original trigger and providing instrumentation recommendations for accurate diagnosis.