systematic-debugging

Guide engineers through four-phase systematic debugging to identify root causes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides engineers to systematically debug issues to identify root causes before proposing fixes, avoiding symptom-focused patches.

Core Features & Use Cases

  • Four-phase framework: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation.
  • Defense-in-depth ensures validation at multiple layers to prevent regression.
  • Works for production incidents, flaky tests, and complex systems, providing concrete steps, checklists, and examples.

Quick Start

  1. Read the overview and goals.
  2. Follow Phase 1 (Root Cause Investigation) checklist, then Phase 2, Phase 3, and Phase 4.
  3. Use the included defense-in-depth patterns to validate data and trace root causes

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I debug a production incident to find the root cause instead of patching symptoms?

Systematic debugging identifies root causes through a four-phase framework: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation, ensuring you fix the actual fault rather than masking symptoms in production incidents.

What is defense-in-depth in debugging and how does it prevent regression?

Defense-in-depth in debugging applies validation at multiple system layers to trace root causes and confirm fixes, preventing regression by ensuring the correction holds across data, logic, and infrastructure boundaries before closing an issue.

What's the best way to debug flaky test failures systematically?

The best way to debug flaky test failures is following the four-phase systematic approach: investigate root causes, analyze failure patterns, form and test hypotheses, then implement fixes with defense-in-depth validation to prevent recurrence.

How do I trace a root cause in a complex system before applying a fix?

Trace root causes in complex systems by following the Root Cause Investigation phase checklist, then use Pattern Analysis to identify correlations and Hypothesis and Testing to validate your findings before moving to implementation.

Can I use systematic debugging for any technical issue or only production bugs?

Systematic debugging applies to any technical issue from production bugs to test failures, providing concrete steps, checklists, and defense-in-depth examples that work across flaky tests, complex systems, and infrastructure problems.

Why does my bug fix keep recurring after patching the symptom?

Bug fixes recur when you patch symptoms without root cause investigation; the systematic debugging framework forces you through Pattern Analysis and Hypothesis Testing phases to identify and validate the actual underlying cause before implementation.