systematic-debugging

Identify root causes before applying fixes in debugging tasks.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/BoraPerusic/agents --skill systematic-debugging-boraperusic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/BoraPerusic/agents/tree/main/skills/to%20try/systematic-debugging
Command: npx skills add https://github.com/BoraPerusic/agents --skill systematic-debugging-boraperusic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random debugging often leads to symptom fixes under time pressure. This skill enforces a root-cause-first approach to debugging, ensuring fixes target underlying issues rather than treating symptoms.

Core Features & Use Cases

  • 4-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation.
  • Anti-pattern defenses and explicit stop rules to prevent rushing and rationalization.
  • Guidance on tracing data flow, using defense-in-depth, and validating outcomes with tests.

Quick Start

Load the skill and begin with Phase 1: Root Cause Investigation before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic root-cause debugging and when do I need it?

Systematic root-cause debugging identifies underlying issues before applying fixes. Use it for software bugs, test failures, or unexpected behavior to ensure reliable resolutions instead of treating symptoms under pressure.

How do I debug software bugs without rushing to apply symptom fixes?

Debug software bugs without rushing by following a 4-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation. This enforces anti-pattern defenses and stop rules to prevent rationalization.

What is the best way to trace data flow and validate debugging outcomes?

The best way to trace data flow and validate outcomes is by using defense-in-depth guidance alongside explicit testing patterns. This ensures fixes target actual root causes rather than superficial symptoms.

Can I apply this systematic debugging approach to test failures?

Yes, you can apply this systematic debugging approach to test failures. It guides engineers through root cause investigation and pattern analysis before proposing any fixes, ensuring reliable resolutions for unexpected behavior.

Why does my debugging process fail to prevent recurring software issues?

Your debugging process fails because random debugging leads to symptom fixes under time pressure. Enforcing a root-cause-first approach with explicit stop rules prevents rushing and rationalization, targeting underlying issues.