systematic-debugging

Identify root causes of bugs through four-phase debugging before applying fixes.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/jetteim/platform-workstation-bootstrap --skill systematic-debugging-jetteim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/jetteim/platform-workstation-bootstrap/tree/main/agents/skills/superpowers/systematic-debugging
Command: npx skills add https://github.com/jetteim/platform-workstation-bootstrap --skill systematic-debugging-jetteim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a structured approach to identify root causes of bugs before applying fixes, reducing wasted effort and rework.

Core Features & Use Cases

  • Enforces four-phase debugging (Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation)
  • Builds defense-in-depth with multi-layer validations and stack-trace instrumentation
  • Use cases: production incidents, flaky tests, complex systems, and strategic debugging under pressure

Quick Start

Begin with Phase 1: Root Cause Investigation, then proceed through Phase 2, Phase 3, and Phase 4 before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I identify the root cause of a bug instead of just fixing the symptom?

To identify a root cause before fixing, follow a structured debugging approach that enforces evidence gathering and pattern analysis across four distinct phases. This prevents symptom-focused remedies and reduces wasted effort on incorrect patches.

What is the best way to debug flaky tests systematically?

The best way to debug flaky tests systematically is to apply a phase-based methodology starting with root cause investigation, followed by pattern analysis and hypothesis testing. This isolates intermittent failures rather than masking them with retries.

How do you handle debugging production incidents under pressure?

Handling production incidents under pressure requires a systematic debugging process that enforces explicit evidence gathering and stack-trace instrumentation. This structured approach prevents rushed, symptom-focused fixes during critical outages.

When should I use a systematic debugging approach for troubleshooting software?

You should use systematic debugging for troubleshooting complex systems, integration failures, and performance problems. It is essential when you need to build defense-in-depth validations to ensure your fixes are robust and maintainable.

What are the steps in phase-based systematic debugging?

Phase-based systematic debugging consists of four steps: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. You must complete all four phases in order before proposing or applying any code fixes.

Why does my bug fix keep causing new issues in complex systems?

Your bug fix likely causes new issues because it addresses symptoms rather than root causes. Applying a systematic debugging methodology with defense-in-depth validations ensures the underlying problem is resolved without introducing regressions.