systematic-debugging

Identifies root causes of software bugs via a four-phase investigation.

641|104|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/eastreams/loong --skill systematic-debugging-eastreams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/eastreams/loong/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/eastreams/loong --skill systematic-debugging-eastreams

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted effort and new bugs by ensuring every technical issue—test failures, production crashes, performance hiccups, or integration errors—is investigated for its true root cause before any fix is applied.

Core Features & Use Cases

  • Four‑phase systematic process: Root cause investigation, pattern analysis, hypothesis testing, and disciplined implementation.
  • Tool‑assisted investigation: Uses file reading, code searching, terminal commands, and version‑control checks to gather evidence.
  • Integration with test‑driven development: Encourages creating failing tests first and validating fixes, suitable for any software debugging scenario.

Quick Start

Ask the systematic-debugging skill to investigate the failing test and guide me through the four phases.

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 how does it help find a software bug's root cause?

Systematic debugging is a methodical investigation process that identifies the true root cause of software bugs or test failures before applying fixes. It uses file reading, code searching, and terminal commands to gather evidence across four phases, preventing wasted effort and new bugs.

How do I debug a failing test using a systematic investigation process?

To debug a failing test, start with root cause investigation using file reading and code searching. Analyze patterns, test hypotheses, and implement fixes using test-driven development, validating that the fix resolves the failure without introducing new issues.

Can I use this systematic debugging approach for production crashes and performance problems?

Yes, this systematic debugging approach applies to production crashes, performance hiccups, and integration errors. It guides you through tool-assisted investigation using terminal commands and version-control checks to gather evidence for any technical issue.

What's the best way to troubleshoot an error investigation without introducing new bugs?

The best way to troubleshoot without introducing new bugs is to apply a disciplined four-phase process: root cause investigation, pattern analysis, hypothesis testing, and implementation. Creating failing tests first validates fixes and ensures the original error is resolved safely.

Does this debugging method require test-driven development to work?

Test-driven development is integrated into the systematic debugging process rather than strictly required. The method encourages creating failing tests first and validating fixes, making it suitable for any software debugging scenario where test-driven practices are adopted.

Why should I investigate root cause before applying a fix to a software bug?

Investigating the root cause before applying a fix prevents wasted effort and new bugs. By using a four-phase investigation with tool-assisted evidence gathering, you ensure the true source of the test failure or crash is addressed rather than just treating symptoms.