systematic-debugging

Investigate bugs through four phases before implementing fixes.

2|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/skytiger6724/qwen-skills --skill systematic-debugging-skytiger6724
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/skytiger6724/qwen-skills/tree/main/systematic-debugging
Command: npx skills add https://github.com/skytiger6724/qwen-skills --skill systematic-debugging-skytiger6724

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes and time pressure waste hours and introduce new bugs because they skip understanding the underlying cause. Systematic debugging forces thorough investigation first so solutions actually stick and recurring problems disappear.

Core Features & Use Cases

  • Phase-gated workflow that requires investigation, pattern analysis, hypothesis testing, and implementation in order, preventing premature changes.
  • Evidence-focused diagnostics covering error reading, reproducible steps, instrumentation, and data-flow tracing to isolate failures across multi-component systems.
  • Decision guardrails with red flags, rationalization counters, and architectural questioning so quick patches and guesswork never derail mission-critical work.

Quick Start

Use the systematic debugging skill to investigate a failing build and gather diagnostics before touching any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of a bug before applying a fix?

Root cause debugging requires completing four investigation phases: evidence gathering, pattern analysis, hypothesis testing, and implementation. This phase-gated workflow prevents premature fixes and eliminates wasted cycles across multi-component systems.

What is the best way to troubleshoot test failures across multi-component systems?

Troubleshooting multi-component failures requires evidence-focused diagnostics covering error reading, reproducible steps, instrumentation, and data-flow tracing. This isolation process prevents quick patches from derailing mission-critical work.

How do I stop quick patches and guesswork from introducing new bugs?

Stop quick patches by applying decision guardrails with red flags, rationalization counters, and architectural questioning. This enforces investigation before changes, preventing guesswork from derailing mission-critical work.

When do I need hypothesis testing for software diagnostics?

Hypothesis testing is needed when encountering bugs, test failures, or unexpected behavior across multi-component systems. It validates pattern analysis during investigation before you propose implementation changes.

Can I use systematic debugging for a failing build without writing fixes first?

Yes, you can use systematic debugging for a failing build to gather diagnostics and investigate root causes before touching fixes. The phase-gated workflow requires completing investigation before implementation.

Why does random debugging waste hours and fail to resolve recurring problems?

Random debugging wastes hours because it skips understanding the underlying cause, leading to patches that introduce new bugs. Systematic investigation enforces root-cause analysis so recurring problems disappear.