systematic-debugging

Coordinate root-cause debugging with a four-phase investigation workflow.

Updated Dec 30, 2025
One-click install
npx skills add https://github.com/bluefishs/CK_Missive --skill systematic-debugging-bluefishs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/bluefishs/CK_Missive/tree/main/.claude/skills/_shared/shared/superpowers/systematic-debugging
Command: npx skills add https://github.com/bluefishs/CK_Missive --skill systematic-debugging-bluefishs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a disciplined, multi-phase approach to identify the root cause of bugs and failures before proposing fixes, preventing symptom-only work.

Core Features & Use Cases

  • Four-phase workflow (Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation) that guides diagnosis and fixes.
  • Anti-patterns, defense-in-depth, and explicit failure modes to resist rushing to quick, superficial patches.
  • Comprehensive guidance for complex systems, time pressure scenarios, and production incidents with verifiable outcomes.

Quick Start

Read error messages, reproduce the issue, complete Phase 1, and then proceed to Phase 2 as needed.

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 a bug instead of just fixing the symptom?

Systematic debugging prevents symptom-only fixes by enforcing a four-phase investigation workflow before implementation. You must complete root cause investigation and pattern analysis phases first, ensuring the actual source of the bug is identified rather than just its visible effects.

What is the best way to debug production incidents under time pressure?

Debugging production incidents under time pressure requires a disciplined, multi-phase debugging approach that resists rushing to quick patches. It provides comprehensive guidance for complex systems, applying defense-in-depth validation and explicit stop criteria to ensure verifiable outcomes during outages.

How do I systematically debug test failures across complex software systems?

Systematically debugging test failures across complex software systems requires a four-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation. This structured process enforces diagnosis completion before fixes and includes defense-in-depth validation.

When should I use a systematic debugging approach instead of quick patches?

You should use a systematic debugging approach instead of quick patches when facing complex bugs, test failures, or outages where superficial fixes risk recurrence. It enforces anti-patterns and explicit failure modes to resist rushing and ensure defense-in-depth validation for long-term reliability.

What are the phases of a systematic root-cause debugging workflow?

The phases of a systematic root-cause debugging workflow are Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation. This structured workflow enforces completion of the initial investigation phase before proceeding to fixes, incorporating explicit stop criteria and defense-in-depth validation.

How do I validate that a software fix actually resolves the root cause?

Validating that a software fix resolves the root cause requires applying defense-in-depth validation and meeting explicit stop criteria within a systematic debugging workflow. This ensures the implemented fix addresses the actual failure source and achieves verifiable outcomes rather than masking symptoms.