systematic-debugging

Diagnose bugs through a four-phase root-cause investigation process.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a disciplined, four-phase approach to diagnosing bugs and failures, ensuring root causes are found before fixes.

Core Features & Use Cases

  • Phase-driven investigation (Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation) with explicit stop rules to prevent shortcuts
  • Anti-patterns, defense-in-depth, and stack-trace instrumentation guidelines that improve reliability and reproduce failures
  • Real-world usage examples and validation tests to train agents on systematic debugging practices

Quick Start

Load the skill and begin with Phase 1 to start root-cause 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 should I use it for root-cause analysis?

Systematic debugging enforces a four-phase process—Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation—with explicit stop rules to prevent shortcut symptom fixes. It applies to development, testing, and production incidents like flaky tests or performance regressions.

How do I debug flaky tests and performance regressions without applying shortcut fixes?

Debug flaky tests and performance regressions by following a four-phase process that uncovers root causes before applying fixes. This enforces disciplined data-flow analysis, phase-by-phase validation, and defense-in-depth checks to prevent shortcut symptom patches.

What is the best way to find a bug's root cause instead of just fixing the symptom?

The best way to find a bug's root cause is using a phase-driven investigation with explicit stop rules. This approach enforces disciplined data-flow analysis and defense-in-depth checks, ensuring you validate the underlying issue before implementing a fix.

How does defense-in-depth apply to bug triage and systematic root-cause investigation?

Defense-in-depth in bug triage improves reliability by adding stack-trace instrumentation guidelines and validation tests. These checks prevent premature symptom fixes by ensuring the root cause is fully reproduced and verified before moving to the implementation phase.

Can I use this systematic debugging process for production incidents as well as local development?

Yes, you can use this systematic debugging process for production incidents, local development, and testing. It applies to diagnosing failures like flaky tests and performance regressions by enforcing phase-by-phase validation regardless of the environment.

Why do my bug fixes keep recurring when I patch the symptom instead of the root cause?

Bug fixes recur when you patch symptoms instead of the root cause because the underlying fault remains. A four-phase systematic debugging process with explicit stop rules enforces data-flow analysis to uncover and eliminate the true origin.