systematic-debugging

Diagnose bugs and production issues using a four-phase systematic workflow.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/mwathiben/PropManager --skill systematic-debugging-mwathiben
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/mwathiben/PropManager/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/mwathiben/PropManager --skill systematic-debugging-mwathiben

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a disciplined, process-driven approach to identifying root causes of bugs and failures, preventing symptom fixes.

Core Features & Use Cases

  • Phase-driven workflow (Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, Implementation)
  • Anti-patterns and defensive patterns to resist time-pressure shortcuts
  • Provides escalation to defense-in-depth strategies and stack-trace techniques
  • Use cases include production incidents, flaky tests, complex multi-service failures

Quick Start

Review the four phases and begin with Phase 1 Root Cause Investigation before proposing any fixes.

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 it for production incidents?

Systematic debugging is a structured, four-phase workflow to diagnose production incidents and identify root causes. You need it when facing complex multi-service failures, flaky tests, or performance problems where fixing symptoms leads to recurring issues.

How do I diagnose a flaky test or production failure using a phase-based workflow?

Diagnose failures by following a four-phase workflow: start with root cause investigation, perform pattern analysis, form and test hypotheses, then implement the fix. This enforces rigorous root cause identification before any code changes are applied.

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

The best way to find a root cause is to enforce Phase 1 investigation before proposing any fixes. This approach uses pattern analysis and hypothesis testing to resist time-pressure shortcuts, ensuring you address the underlying defect rather than surface-level symptoms.

Can I use this systematic debugging approach for multi-service architecture failures?

Yes, this systematic debugging workflow is specifically applicable to complex multi-service architectures. It uses stack-trace techniques and defense-in-depth validation to trace failures across distributed codebases and production environments.

Why does my bug fix keep recurring even after patching the stack trace errors?

Bug fixes recur when you patch stack trace symptoms without identifying the actual root cause. A systematic debugging workflow prevents this by mandating root cause investigation and pattern analysis before any implementation, adding defense-in-depth validation.