systematic-debugging

Breaks down bug-finding into a structured four-step process for engineers.

Updated May 6, 2026
One-click install
npx skills add https://github.com/johan-Rm/agents --skill systematic-debugging-johan-rm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/johan-Rm/agents/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/johan-Rm/agents --skill systematic-debugging-johan-rm

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill solves the issue of inefficient, guess-based debugging that leads to flaky fixes, recurring issues, and wasted development time.

Core Features & Use Cases

  • Root Cause Analysis: Provides a structured four-phase framework to identify the underlying cause before applying any fixes.
  • Defense-in-Depth: Offers patterns for multi-layer validation to make bugs structurally impossible.
  • Reliable Testing: Includes utilities for condition-based waiting to replace brittle, arbitrary timeouts in test suites.
  • Use Case: When a test fails intermittently in CI, use this skill to trace the data flow, identify the race condition, and implement a robust wait condition that ensures 100% test reliability.

Quick Start

Initiate the systematic debugging process to investigate the current test failure by tracing the data flow and identifying the root cause.

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 test failures in CI?▼

A systematic debugging process enforces root cause investigation before applying fixes, utilizing a structured four-phase framework to trace data flow, analyze patterns, and identify underlying causes in complex software systems.

What is the best way to debug production bugs without guessing?▼

The best way to debug production bugs without guessing is to apply a four-phase scientific framework that enforces systematic tracing and pattern analysis to pinpoint the exact defect before implementation.

How can I make software bugs structurally impossible to prevent recurring issues?▼

You can make software bugs structurally impossible by applying defense-in-depth patterns that enforce multi-layer validation techniques, ensuring architectural integrity and preventing flaky fixes from recurring.

Does this systematic debugging approach work for performance issues and complex software systems?▼

Yes, this systematic debugging approach works for performance issues and complex software systems by applying rigorous root cause analysis and multi-layer validation to ensure defects are resolved without architectural compromise.

Why should I use a scientific debugging process instead of applying quick fixes?▼

You should use a scientific debugging process instead of quick fixes because guess-based debugging leads to flaky fixes, recurring issues, and wasted development time, whereas systematic tracing ensures permanent resolution.