systematic-debugging

Investigate bugs and test failures to find root causes before proposing fixes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging helps you avoid guesswork, quick patches, and symptom-chasing when a bug, test failure, or unexpected behavior appears.

Core Features & Use Cases

  • Root-cause first workflow: Forces you to investigate errors, reproduce issues, review recent changes, and trace data flow before proposing any fix.
  • Structured debugging phases: Guides you through investigation, pattern analysis, hypothesis testing, and implementation so you can debug methodically under pressure.
  • Guardrails against bad fixes: Warns against multiple simultaneous changes, unsupported assumptions, and repeated fix attempts that hide the true source of the problem.
  • Use case: Ideal for flaky tests, production incidents, integration failures, performance regressions, and deep call-stack bugs where the first visible error is not the real cause.

Quick Start

Use the systematic-debugging skill to investigate the issue by reading the error carefully, reproducing it, checking recent changes, and tracing the root cause before making any fix.

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 test failures instead of just patching symptoms?

To find the root cause of flaky test failures, you must read errors carefully, reproduce the issue, review recent changes, and trace data flow before proposing any fix. This systematic debugging approach prevents symptom-chasing and ensures you address the actual source of the problem.

What is the best way to debug production incidents without making multiple simultaneous changes?

The best way to debug production incidents is to follow a structured debugging workflow that tests single hypotheses and gathers evidence. Making multiple simultaneous changes hides the true source of the problem, so a systematic approach traces the root cause before implementing the fix.

How do I systematically investigate performance regressions and multi-component failures?

To systematically investigate performance regressions and multi-component failures, apply pattern comparison and evidence gathering to trace data flow across components. By testing a single hypothesis at a time and using failing-test-driven root-cause fixes, you methodically isolate the regression under pressure.

When should I use a systematic debugging workflow for build failures?

You should use a systematic debugging workflow for build failures when the first visible error is not the real cause and quick patches are tempting. It guides you through investigation, pattern analysis, hypothesis testing, and implementation to methodically resolve deep call-stack bugs.

Why does repeatedly attempting bug fixes without a hypothesis hide the true source of unexpected behavior?

Repeatedly attempting bug fixes without a hypothesis hides the true source of unexpected behavior because unsupported assumptions replace evidence gathering. Systematic debugging enforces careful error reading and single-hypothesis testing to ensure the root cause is identified before any code is changed.