systematic-debugging

Diagnose bugs through a four-phase root-cause investigation with evidence gathering.

6|2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/GregsGreyCode/Logos --skill systematic-debugging-gregsgreycode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/GregsGreyCode/Logos/tree/main/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/GregsGreyCode/Logos --skill systematic-debugging-gregsgreycode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes waste time and create new bugs. This skill enforces a four-phase root-cause investigation to ensure you understand the problem before attempting any fixes.

Core Features & Use Cases

  • Phase-driven debugging: a structured, repeatable approach to identify root causes.
  • Diagnostic instrumentation: gather evidence across components to pinpoint failure sources.
  • Regression-ready workflow: leads to validation tests and robust fixes with minimal rework.

Quick Start

Describe the issue and start Phase 1 to begin 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 a phased root-cause investigation?

Systematic debugging is a four-phase root-cause investigation method. Use it for test failures, production bugs, unexpected behavior, and performance issues to ensure you understand the problem before attempting fixes.

How do I fix production bugs without causing regressions?

Fix production bugs by executing a four-phase root-cause investigation that enforces evidence gathering, data-flow tracing, and reproducible steps. This regression-ready workflow leads to validation tests and robust fixes with minimal rework.

How do I stop applying random fixes that create new bugs?

Stop random fixes by using a structured debugging approach that enforces evidence gathering and data-flow tracing to pinpoint failure sources. This disciplined process ensures you understand the problem before attempting any fixes.

What's the best way to diagnose unexpected software behavior and test failures?

The best way to diagnose unexpected behavior and test failures is applying a structured, repeatable four-phase approach. This method focuses on diagnostic instrumentation to gather evidence across components and identify root causes.

Can I use this phased debugging approach for performance issues across any software project?

Yes, you can apply this four-phase root-cause investigation to performance issues across software projects. It works by enforcing evidence gathering, data-flow tracing, and reproducible steps to pinpoint failure sources accurately.

Why does my troubleshooting workflow fail to find the actual root cause?

Troubleshooting workflows fail when they attempt premature fixes without gathering evidence. A disciplined four-phase investigation forces data-flow tracing and reproducible steps to pinpoint the true failure source before any changes are made.