systematic-debugging

Apply a four-phase framework requiring root cause analysis before implementing software bug fixes.

9|Updated Jul 3, 2026
One-click install
npx skills add https://github.com/TonyQ-AI/agents-workflow --skill systematic-debugging-tonyq-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/TonyQ-AI/agents-workflow/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/TonyQ-AI/agents-workflow --skill systematic-debugging-tonyq-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the common issue of inefficient, trial-and-error debugging that leads to wasted time, recurring issues, and the introduction of new bugs. It enforces a rigorous, four-phase process to ensure you address the root cause rather than just the symptoms.

Core Features & Use Cases

  • Root Cause Mandate: Prevents "shotgun debugging" by requiring a full investigation before any fix is proposed.
  • Multi-Layered Defense: Provides techniques like root-cause tracing and condition-based waiting to ensure fixes are robust and verifiable.
  • Use Case: When a production API fails intermittently, use this skill to trace the data flow, identify the specific component boundary causing the failure, and implement a permanent fix with automated test coverage.

Quick Start

Load the systematic-debugging skill to begin a structured investigation into the current bug or test failure.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I debug intermittent production API failures instead of guessing?

Debug intermittent production API failures by enforcing a four-phase systematic debugging framework that mandates root cause analysis. This process requires collecting evidence, tracing data flow across component boundaries, and testing hypotheses before proposing a permanent fix.

What is the best way to find the root cause of race conditions and multi-component system errors?

The best way to find the root cause of race conditions and multi-component system errors is systematic evidence collection and hypothesis testing. This approach prevents shotgun debugging by requiring a full investigation into the specific component boundary causing the failure before implementing any code changes.

How do I stop recurring software bugs caused by trial-and-error troubleshooting?

Stop recurring software bugs caused by trial-and-error troubleshooting by mandating root cause analysis before implementation. This systematic debugging method implements multi-layer defensive checks and condition-based waiting to ensure fixes are robust, verifiable, and prevent new bugs from being introduced.

When do I need a systematic debugging process for complex software issues?

You need a systematic debugging process for complex software issues involving intermittent failures, race conditions, and multi-component system errors. This rigorous four-phase framework ensures you address the root cause rather than just symptoms, eliminating wasted time from inefficient trial-and-error debugging.

Does systematic debugging work for fixing complex multi-component system errors?

Yes, systematic debugging works for complex multi-component system errors by providing a rigorous four-phase framework. It applies techniques like root-cause tracing and condition-based waiting to identify specific component boundaries causing failures and implement permanent fixes with automated test coverage.