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.