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.