systematic-debugging

Identify and resolve software bugs through a four-phase investigation process.

7|1|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/paxlabs-inc/ion-agent --skill systematic-debugging-paxlabs-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/paxlabs-inc/ion-agent/tree/main/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/paxlabs-inc/ion-agent --skill systematic-debugging-paxlabs-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the common pitfall of guessing and applying quick patches, which often mask underlying issues and create new bugs. It enforces a rigorous, scientific approach to troubleshooting that ensures problems are resolved at their root.

Core Features & Use Cases

  • Root Cause Investigation: Provides a structured 4-phase methodology to isolate failures, trace data flow, and verify hypotheses.
  • Tight Feedback Loops: Guides the creation of deterministic, agent-runnable reproduction commands to ensure fixes are validated against the exact symptom.
  • Architectural Guardrails: Prevents "thrashing" by mandating a stop-and-review process if three or more fix attempts fail, identifying when a problem is architectural rather than a simple bug.

Quick Start

Use the systematic-debugging skill to investigate the failing test case in the current repository by following the four-phase process.

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 failing test instead of applying quick patches?

To find the root cause of a failing test, you need a structured debugging methodology that isolates failures and verifies hypotheses through deterministic feedback loops before implementing code changes. This ensures problems are resolved at their source rather than masked.

What's the best way to troubleshoot production errors systematically?

The best way to troubleshoot production errors systematically is following a four-phase investigation process that traces data flow and constructs deterministic, runnable reproduction commands to validate fixes against the exact symptom.

Why does my debugging process thrash and fail to resolve software bugs after multiple attempts?

Debugging thrashes when multiple fix attempts fail because the underlying issue is likely architectural rather than a simple bug. A stop-and-review process after three or more failed attempts identifies when architectural changes are required.

How do I create deterministic feedback loops for investigating performance regressions?

Create deterministic feedback loops for performance regressions by building agent-runnable reproduction commands that consistently trigger the exact symptom, allowing you to verify your root cause hypothesis before changing code.

Can I use a systematic troubleshooting approach for both test failures and performance regressions?

Yes, a systematic troubleshooting approach applies to technical scenarios including test failures, production errors, and performance regressions by enforcing a scientific investigation process across all types of software bugs.

When should I stop guessing at fixes and switch to a root cause investigation process?

You should stop guessing at fixes immediately and switch to root cause investigation when quick patches begin masking underlying issues or creating new bugs, as guessing eliminates the verification of actual failure origins.