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.