systematic-debugging

Diagnose root causes through a four-phase debugging workflow.

3|2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/Moonsong-Labs/knowledge-work-plugins --skill systematic-debugging-moonsong-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Moonsong-Labs/knowledge-work-plugins/tree/main/core-engineering/skills/systematic-debugging
Command: npx skills add https://github.com/Moonsong-Labs/knowledge-work-plugins --skill systematic-debugging-moonsong-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined framework to uncover root causes instead of patching symptoms, reducing wasted time and rework during incidents.

Core Features & Use Cases

  • Four-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation.
  • Anti-patterns and defense-in-depth to prevent shortcut fixes.
  • Integration with test-driven development practices and root-cause tracing.

Quick Start

Load the skill and follow its four-phase process to identify root causes before proposing 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 a phase-based approach?

Systematic debugging is a disciplined framework to uncover root causes before applying fixes. You need it during incidents involving software bugs, test failures, production issues, or flaky behaviors across multi-component systems to eliminate root causes instead of patching symptoms.

How do I diagnose root causes in debugging sessions before proposing fixes?

To diagnose root causes, follow a four-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation. This process guides you through data gathering, pattern analysis, hypothesis testing, and safe implementation to eliminate the underlying issue.

Can I use systematic debugging for flaky behaviors and production issues across multi-component systems?

Yes, systematic debugging applies to flaky behaviors and production issues across multi-component systems. It guides investigators through data gathering and hypothesis testing to ensure you address the actual root cause rather than applying shortcut symptom fixes.

What's the best way to prevent shortcut fixes during root cause tracing?

The best way to prevent shortcut fixes is applying anti-patterns and defense-in-depth guidance during root cause tracing. This ensures you validate hypotheses and implement test-driven fixes rather than patching symptoms prematurely.

Does systematic debugging integrate with test-driven development practices?

Yes, systematic debugging integrates with test-driven development practices for validation and traceability. It references core-engineering tools to ensure fixes are validated by tests, preventing regression and confirming the root cause is eliminated.