systematic-debugging

Investigate software bugs through phases covering analysis, hypothesis testing, and implementation.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/ghufronbagaskara/agent-im --skill systematic-debugging-ghufronbagaskara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/ghufronbagaskara/agent-im/tree/main/hermes-home/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/ghufronbagaskara/agent-im --skill systematic-debugging-ghufronbagaskara

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents the common pitfall of applying random, ineffective patches to software bugs by enforcing a disciplined, evidence-based investigation process that identifies and resolves root causes.

Core Features & Use Cases

  • Root Cause Isolation: Guides the agent through error analysis, data flow tracing, and reproduction loop construction to ensure the underlying issue is understood before any code is changed.
  • Scientific Testing: Implements a structured hypothesis-testing framework that requires minimal, single-variable probes to verify potential fixes.
  • Use Case: When a production service experiences intermittent failures, this skill forces the agent to build a deterministic reproduction loop and trace data flow across component boundaries rather than guessing at a fix.

Quick Start

Use the systematic-debugging skill to investigate the failing test case in the authentication module by first building a tight reproduction loop.

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 intermittent software bugs in production?

Systematic debugging isolates root causes by guiding error analysis, data flow tracing, and reproduction loop construction. This ensures the underlying issue is fully understood before any code is changed, preventing ineffective random patches.

What is the best way to debug failing test cases in my software?

The best way to debug failing test cases is applying a structured hypothesis-testing framework that uses minimal, single-variable probes to verify potential fixes. This scientific testing approach ensures accurate troubleshooting for software failures.

How do I troubleshoot performance regressions without applying random patches?

To troubleshoot performance regressions without random patches, enforce a disciplined, evidence-based investigation process. This involves isolating the root cause through data flow tracing and verifying fixes with single-variable probes before implementation.

What do I need to run systematic debugging for technical troubleshooting?

You need terminal access for test execution and file system access for code analysis and instrumentation to run systematic debugging. These environment permissions allow the agent to build reproduction loops and trace data.

Why should I use a structured debugging process instead of guessing at fixes?

You should use a structured debugging process instead of guessing to prevent applying ineffective patches to software bugs. A rigorous methodology enforces evidence-based investigation, ensuring you identify and resolve actual root causes.