systematic-debugging

Guide engineers through a four-phase root-cause debugging workflow before applying fixes.

20|4|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/Alenryuichi/openmemory-plus --skill systematic-debugging-alenryuichi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Alenryuichi/openmemory-plus/tree/main/.augment/skills/systematic-debugging
Command: npx skills add https://github.com/Alenryuichi/openmemory-plus --skill systematic-debugging-alenryuichi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging enforces a disciplined, root-cause-first approach to diagnosing bugs, reducing wasted time on symptom fixes and preventing regression from hasty patches.

Core Features & Use Cases

  • Phase-driven workflow with four phases (Phase 1 through Phase 4) and mandatory progression to ensure thorough analysis.
  • Anti-patterns and defense-in-depth guidance to harden debugging practice.
  • Techniques like root-cause tracing and stack-agnostic evidence gathering for deep issues.
  • Use cases include code bugs, test failures, production incidents, flaky tests, and complex systems debugging.

Quick Start

Load the skill and follow Phase 1 through Phase 4 to identify root cause before implementing fixes.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is root-cause debugging and when do I need it for my code?

Root-cause debugging diagnoses bugs by enforcing thorough investigation before applying fixes. You need it for code bugs, test failures, performance issues, and unexpected behavior across development, staging, and production environments to stop symptom fixes.

How do I debug flaky tests and production incidents systematically?

Debug flaky tests and production incidents systematically by following a phase-based workflow from Phase 1 through Phase 4. This enforces mandatory progression and uses root-cause tracing with stack-agnostic evidence gathering to identify the true underlying issue.

Does systematic debugging work for complex systems and production environments?

Yes, systematic debugging works for complex systems and production environments. It applies stack-agnostic evidence gathering and defense-in-depth guidance to diagnose deep issues, ensuring thorough analysis before fixes are implemented across any environment.

What is the best way to stop applying symptom fixes and prevent regression from hasty patches?

The best way to stop symptom fixes is to enforce a disciplined, root-cause-first approach using anti-patterns and defense-in-depth guidance. This prevents regression from hasty patches by requiring root-cause tracing before implementing any code fixes.

Why does my debugging workflow fail to find the root cause of unexpected behavior?

Your debugging workflow fails to find the root cause of unexpected behavior when it skips the mandatory phase-based progression. Without root-cause tracing and anti-pattern avoidance, you risk applying symptom fixes instead of identifying the actual defect.

What are the limitations of root-cause debugging for test failures?

Root-cause debugging for test failures requires strict adherence to the four-phase workflow and mandatory progression, which may slow down initial diagnosis. However, this disciplined approach ensures thorough analysis and prevents regression from hasty patches.