systematic-debugging

Identify root causes of bugs and failing tests before applying fixes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random or superficial fixes waste time, introduce new bugs, and leave the underlying causes unresolved. This Skill enforces a disciplined, evidence-driven workflow so engineers reliably identify and fix root causes instead of masking symptoms.

Core Features & Use Cases

  • Four-phase, checklist-driven process: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation with stop conditions.
  • Pressure-resistant guidance: Explicit anti-patterns, red flags, and language to resist rushed or social-pressure-driven shortcuts.
  • Practical tools and references: Includes tracing and instrumentation techniques, a bisection helper for test pollution, condition-based waiting patterns, and defense-in-depth validation strategies to make bugs structurally impossible.
  • Use cases: Debugging flaky tests, diagnosing production incidents, investigating integration failures across components, and preventing repeated symptom fixes during code reviews.

Quick Start

Run the four-phase systematic debugging checklist on the failing test or incident, gather evidence at component boundaries, form a single hypothesis, create a minimal failing test, and verify the single fix before committing.

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 fixing symptoms?

To find the root cause of flaky tests, you need a systematic debugging workflow that gathers evidence at component boundaries, forms a single hypothesis, and creates a minimal failing test before applying fixes. This prevents superficial patches that mask underlying issues.

What is the best way to debug production incidents across multi-component integration failures?

The best way to debug production integration failures is to use diagnostic instrumentation at component boundaries and establish reproducible reproduction steps. Evidence-driven bisection and pattern analysis ensure you identify the exact root cause before committing iterative fixes.

How do I stop repeated symptom fixes during code reviews and prevent masked bugs?

To stop repeated symptom fixes during code reviews, apply a four-phase systematic debugging checklist that enforces explicit stop conditions and defense-in-depth validation. This ensures engineers verify single fixes and make bugs structurally impossible rather than applying rushed patches.

Can I use bisection to triage test pollution and diagnose failing unit tests?

Yes, you can use bisection to triage test pollution and diagnose failing unit tests. A bisection helper narrows down the polluting test cases, while condition-based waiting patterns and single-hypothesis minimal tests confirm the exact root cause before you implement a fix.

When should I not use a systematic debugging approach for diagnosing bugs?

You should avoid systematic debugging when you lack reproducible reproduction steps or cannot instrument component boundaries. Without evidence-driven inputs and explicit stop conditions, the four-phase root cause investigation process cannot effectively form or validate a single hypothesis.

Why does random fixing waste time and introduce new bugs in software engineering?

Random fixing wastes time and introduces new bugs because it leaves underlying causes unresolved. A disciplined, evidence-driven workflow with anti-patterns and red flags resists social-pressure-driven shortcuts, ensuring engineers reliably identify root causes instead of masking symptoms.