systematic-debugging

Guide structured four-phase debugging to identify root causes of technical problems.

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/lvstb/nix-config --skill systematic-debugging-lvstb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/lvstb/nix-config/tree/main/home/opencode/skills/systematic-debugging
Command: npx skills add https://github.com/lvstb/nix-config --skill systematic-debugging-lvstb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents the common and costly mistake of applying quick fixes that mask underlying issues, leading to recurring bugs and wasted development time. It enforces a rigorous process for identifying and resolving the true root cause of any technical problem.

Core Features & Use Cases

  • Root Cause Analysis: Guides users through a structured four-phase process to identify the fundamental reason for a bug.
  • Systematic Investigation: Emphasizes careful error message reading, consistent reproduction, and evidence gathering.
  • Use Case: When a critical test fails in CI, instead of guessing, use this Skill to meticulously trace the error back to its origin, ensuring a permanent fix.

Quick Start

Use the systematic-debugging skill to investigate the root cause of the recent build 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 bug instead of just masking the symptoms?

Root cause analysis for bug fixing requires a structured four-phase process: carefully reading error messages, consistently reproducing the issue, gathering evidence, and tracing data flow before proposing any fixes. This approach prevents quick fixes from masking underlying issues.

What is the best way to troubleshoot unexpected behavior and test failures in CI?

Troubleshooting test failures and unexpected behavior involves meticulous investigation rather than guessing. You must trace the error back to its origin by gathering evidence and tracing data flow, ensuring you identify the fundamental reason for the failure before applying a permanent fix.

How do I systematically debug an issue when I cannot consistently reproduce the error?

Systematic debugging emphasizes consistent reproduction as a core phase of investigation. You must gather evidence and trace data flow to understand the exact conditions triggering the unexpected behavior, ensuring the root cause is identified even when initial reproduction is difficult.

When should I use a systematic debugging process for bug fixing?

You should use systematic debugging when a critical test fails or unexpected behavior occurs, and you want to avoid recurring bugs. It enforces a rigorous process of evidence gathering and root cause tracing to ensure a permanent fix rather than a temporary patch.

Can I apply root cause analysis to any technical problem, or is it limited to software bugs?

Root cause analysis applies to any technical problem, including bugs, test failures, and unexpected behavior. The structured investigation process guides you through reading error messages and tracing data flow to identify the fundamental reason for the issue across various contexts.

Why do my bug fixes often lead to recurring issues in the same system?

Recurring bugs happen when quick fixes mask underlying issues instead of resolving the true root cause. Applying a rigorous investigation process to trace data flow and gather evidence before fixing ensures the fundamental reason for the bug is permanently eliminated.