superpowers-systematic-debugging

Identify and fix root causes of bugs using a four-phase debugging process.

2|1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/aldoborrero/agent-kit --skill superpowers-systematic-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-systematic-debugging
Source: https://github.com/aldoborrero/agent-kit/tree/main/skills/superpowers/systematic-debugging
Command: npx skills add https://github.com/aldoborrero/agent-kit --skill superpowers-systematic-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers uncover root causes of bugs and failures by enforcing a disciplined four-phase debugging process, preventing symptom fixes.

Core Features & Use Cases

  • Four-phase workflow: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis & Testing, Phase 4 Implementation.
  • Anti-patterns and defense-in-depth guidance to resist rushing to fixes.
  • Real-world debugging scenarios and references included to illustrate best practices.

Quick Start

Follow Phase 1 to begin root-cause investigation before proposing any fixes.

Frequently Asked Questions about superpowers-systematic-debugging

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

FAQPage Schema
What is a systematic debugging process for finding software defect root causes?

Systematic debugging identifies root causes of software defects by enforcing a four-phase process: root-cause investigation, pattern analysis, hypothesis testing, and implementation with defense-in-depth. This prevents rushing to symptom fixes.

How do I debug test failures without just patching the symptoms?

Debugging test failures without patching symptoms requires starting with Phase 1 root-cause investigation, then analyzing patterns and testing hypotheses before implementing defense-in-depth fixes to ensure the underlying failure is resolved.

When do I need a structured debugging workflow for CI pipeline failures?

You need a structured debugging workflow for CI pipeline failures when unexpected runtime behavior recurs across projects or teams, requiring disciplined pattern analysis and hypothesis testing to prevent repetitive symptom patching.

What's the best way to stop engineers from rushing to fix bugs before understanding them?

The best way to stop rushing to fixes is applying anti-patterns and defense-in-depth guidance within a disciplined four-phase workflow, enforcing root-cause investigation and pattern analysis before any implementation begins.

Can I use this debugging method across different projects and teams?

Yes, this systematic debugging method applies to software defects, test failures, and unexpected runtime behavior across diverse projects, teams, and CI pipelines by following the structured four-phase investigation process.

Why does my bug fix keep reintroducing the same unexpected runtime behavior?

Your bug fix reintroduces unexpected runtime behavior because it likely patches symptoms instead of root causes, which a disciplined four-phase debugging process with hypothesis testing and defense-in-depth prevents.