systematic-debugging

Identify and resolve root causes of technical bugs through a four-phase framework.

Updated Jul 18, 2026
One-click install
npx skills add https://github.com/arthrod/conejo-skills --skill systematic-debugging-arthrod
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/arthrod/conejo-skills/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/arthrod/conejo-skills --skill systematic-debugging-arthrod

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill solves the common issue of inefficient, trial-and-error debugging that leads to wasted time, masked symptoms, and the introduction of new bugs.

Core Features & Use Cases

  • Root Cause Mandate: Enforces a strict four-phase process (Investigation, Pattern Analysis, Hypothesis, Implementation) to ensure the underlying issue is resolved rather than just the symptom.
  • Pressure-Resistant Framework: Provides explicit anti-patterns and checklists to prevent rationalization and shortcuts during high-pressure production incidents.
  • Multi-Layer Validation: Integrates defense-in-depth strategies, including data flow tracing and condition-based waiting, to make bugs structurally impossible.

Quick Start

Load the systematic debugging skill and follow the four-phase checklist to identify the root cause of the current test failure.

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 software bug instead of just fixing the symptoms?

To find the root cause of a software bug, apply a systematic four-phase framework: Investigation, Pattern Analysis, Hypothesis, and Implementation. This ensures the underlying issue is resolved rather than masked by trial-and-error patching.

What is the best way to debug production incidents under pressure without taking shortcuts?

Debugging production incidents under pressure requires a rigorous framework with explicit anti-patterns and checklists. This prevents rationalization and shortcuts, enforcing systematic investigation and hypothesis testing to resolve the failure permanently.

How do I systematically troubleshoot complex system test failures?

To systematically troubleshoot complex test failures, follow a structured process of data flow tracing and condition-based waiting. This multi-layer validation identifies exact failure points and ensures bugs become structurally impossible through defense-in-depth.

Does systematic debugging work for general software development or only for production incident response?

Systematic debugging applies to both general software development and production incident response. The root cause mandate and multi-layer validation strategies are designed for any complex system troubleshooting requiring permanent bug resolution.

Why does trial-and-error debugging often introduce new bugs and waste time?

Trial-and-error debugging wastes time and introduces new bugs because it masks symptoms instead of resolving the underlying root cause. A systematic approach enforces strict hypothesis testing to prevent inefficient rationalization.

When should I not use guess-and-check methods for troubleshooting technical failures?

You should avoid guess-and-check troubleshooting whenever facing complex system failures or high-pressure production incidents. Instead, use a rigorous framework enforcing investigation and defense-in-depth validation to make bugs structurally impossible.