systematic-debugging

Trace root causes of bugs through a four-phase investigation process.

6|2|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/EricOo0/stock-trading-platform --skill systematic-debugging-ericoo0
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/EricOo0/stock-trading-platform/tree/main/.codex/superpowers/skills/systematic-debugging
Command: npx skills add https://github.com/EricOo0/stock-trading-platform --skill systematic-debugging-ericoo0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging helps teams identify the true root cause of bugs and failures instead of applying symptom-level patches.

Core Features & Use Cases

  • Four-Phase Process: Enforces root-cause investigation before fixes, with Phase 1 through Phase 4 and explicit stop rules.
  • Anti-Pattern & Defense-in-Depth: Includes warnings against quick fixes and adds multiple defensive layers to prevent regression.
  • Real-World Scenarios: Provides structured guidance for production incidents, flaky tests, and code defects, with practical examples and templates.
  • Documentation & Tools: References to root-cause-tracing, defense-in-depth, and waiting utilities to support robust debugging workflows.

Quick Start

Load the Systematic Debugging skill, review the four phases, and follow Phase 1 first to begin investigation.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and when do I need root-cause analysis?▼

Systematic debugging is a structured process to identify the true root cause of bugs before applying fixes. You need it when symptom-level patches fail to prevent recurring failures in code, tests, or production incidents.

How do I debug production incidents step by step?▼

Debug production incidents by following a four-phase systematic process: gather evidence, trace the root cause through phase-wise analysis, apply a targeted fix, and implement defense-in-depth practices to ensure reliable resolutions.

How do I fix flaky tests without applying quick patches?▼

Fix flaky tests by investigating the root cause using a phase-based debugging process with explicit stop rules, ensuring evidence gathering confirms the failure source before proposing robust fixes.

What is the best way to prevent bug regression after a fix?▼

Prevent bug regression by applying defense-in-depth practices during debugging, which adds multiple defensive layers around the root-cause fix to prevent the same failure from recurring.

Does this systematic debugging process work for code defects and production failures?▼

Yes, the systematic debugging process applies across code defects, flaky tests, and production incidents, guiding users through evidence gathering and phase-wise analysis to resolve failures reliably.

Why should I avoid quick fixes when debugging code failures?▼

Avoid quick fixes because they address symptoms rather than the root cause, leading to regression. Systematic debugging enforces root-cause investigation first to ensure the underlying failure is reliably resolved.