systematic-debugging

Guide root cause analysis through investigation, pattern analysis, hypothesis testing, and implementation phases.

5|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/lidge-jun/cli-jaw-skills --skill systematic-debugging-lidge-jun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/lidge-jun/cli-jaw-skills/tree/main/debugging-helpers
Command: npx skills add https://github.com/lidge-jun/cli-jaw-skills --skill systematic-debugging-lidge-jun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill prevents wasted time and new bugs caused by random fixes or patching symptoms, ensuring you always find and address the root cause of any technical issue.

Core Features & Use Cases

  • Systematic Investigation: Guides you through a 4-phase process (Investigation, Pattern Analysis, Hypothesis, Implementation) to methodically uncover the origin of bugs.
  • Pressure Resistance: Provides explicit rules and anti-patterns to counteract rationalizations made under time pressure or exhaustion.
  • Use Case: When a critical API is failing in production, use this Skill to ensure you don't just apply a quick patch, but systematically identify and fix the underlying architectural flaw, saving hours of future rework.

Quick Start

Use the systematic-debugging skill when encountering any bug, test failure, or unexpected behavior before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging process for finding the root cause of software bugs?

A systematic debugging process enforces evidence gathering across investigation, pattern analysis, hypothesis testing, and implementation phases to pinpoint the exact root cause of software bugs. It prevents wasted time by avoiding symptom-based fixes.

How do I stop applying quick patches that cause new bugs in production?

To stop applying quick patches that cause new bugs, follow explicit rules and anti-patterns that resist rationalization under time pressure. This enforces a structured methodology to address the underlying architectural flaw instead of the symptom.

What are the steps to troubleshoot a critical API failure systematically?

Troubleshooting a critical API failure systematically requires moving through four phases: investigating the failure, analyzing patterns, testing hypotheses, and implementing the fix. This methodology ensures you uncover the origin rather than patching symptoms.

Why do developers fail to fix bugs right under time pressure?

Developers fail to fix bugs right under time pressure due to rationalization and exhaustion, leading to symptom-based fixes. A structured methodology counters this by providing explicit anti-patterns to resist pressure and ensure evidence-based root cause analysis.

When should I use a systematic root cause analysis for error analysis?

You should use systematic root cause analysis whenever you encounter any bug, test failure, or unexpected behavior before proposing fixes. Applying this structured process early prevents the wasted time and future rework associated with random fixes.