systematic-debugging

Diagnose software defect root causes through a four-phase investigation workflow.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/chuangkevin/project-bridge --skill systematic-debugging-chuangkevin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/chuangkevin/project-bridge/tree/main/skill/superpowers/systematic-debugging
Command: npx skills add https://github.com/chuangkevin/project-bridge --skill systematic-debugging-chuangkevin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random or rushed fixes create recurring bugs, wasted time, and fragile code; this Skill enforces a disciplined, evidence-driven approach to identify and fix the actual root cause of failures rather than their symptoms. It prevents thundering changes under pressure and reduces regressions by insisting on reproducibility, instrumentation, and minimal, test-backed fixes.

Core Features & Use Cases

  • Four-phase workflow: mandatory Phase 1 (investigation), Phase 2 (pattern analysis), Phase 3 (single-hypothesis testing), and Phase 4 (implementation with failing test and verification).
  • Pressure-resistant rules: explicit anti-patterns, red flags, and stop-and-reanalyze guidance to resist quick-fix rationalization during incidents or time pressure.
  • Supporting techniques & tools: backward root-cause tracing, defense-in-depth validation, condition-based waiting utilities, and a test bisection helper for finding polluting tests; ideal for production incidents, flaky test stabilization, and integration failure triage.

Quick Start

Analyze this failing test or production error and guide me through Phase 1 to reproduce it, gather evidence at component boundaries, and identify the most likely root cause.

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 flaky tests instead of just patching symptoms?

To find the root cause of flaky tests, you need a systematic debugging workflow that reproduces the failure, analyzes patterns, and tests a single hypothesis with minimal changes before applying a test-backed fix.

What is the best way to debug production incidents without causing regressions?

The best way to debug production incidents without regressions is applying evidence-driven investigation with backward root-cause tracing and defense-in-depth validation, resisting rushed quick-fix rationalization under time pressure.

How do I debug build failures step by step when the error is hard to reproduce?

Debugging build failures step by step requires a four-phase workflow: investigate to reproduce, analyze patterns, test a single hypothesis with minimal changes, then implement the fix backed by a failing test for verification.

Why does my debugging process result in recurring bugs and fragile code?

Recurring bugs and fragile code result from random or rushed fixes that address symptoms rather than root causes; enforcing reproducibility, instrumentation, and minimal, test-backed fixes prevents this cycle.

Can I use test bisection to find polluting tests in a failing integration suite?

Yes, you can use a test bisection helper to find polluting tests in a failing integration suite by systematically narrowing down the test execution order that causes cross-test contamination and state leakage.

When should I stop and reanalyze during a production incident investigation?

You should stop and reanalyze during a production incident investigation when you encounter explicit red flags or anti-patterns, switching from quick-fix rationalization back to evidence-driven pattern analysis and hypothesis testing.