systematic-debugging

Trace bugs to their original trigger using defense-in-depth analysis.

33|6|Updated Oct 9, 2025
One-click install
npx skills add https://github.com/CraftsMan-Labs/SimpleAgents --skill systematic-debugging-craftsman-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/CraftsMan-Labs/SimpleAgents/tree/main/.opencode/skills/systematic-debugging
Command: npx skills add https://github.com/CraftsMan-Labs/SimpleAgents --skill systematic-debugging-craftsman-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a disciplined framework to diagnose bugs, preventing symptom-focused fixes by requiring root-cause investigation and evidence-driven decision making.

Core Features & Use Cases

  • Phase-driven methodology with Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation to ensure robust fixes.
  • Defense-in-depth guidance including multiple validation layers and stack-trace instrumentation to prevent regression and improve observability.
  • Real-world risk reduction: faster debugging cycles, higher first-time fix rates, and clearer traceability across components.

Quick Start

Apply the systematic debugging process to investigate the root cause of a failing test or bug in the current project.

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 fixing the symptom?

To find a root cause, apply a phased debugging methodology that traces the bug to its original trigger, gathers stack-trace evidence, and validates the fix across multiple layers to prevent symptom-driven patches.

What is a defense-in-depth approach to debugging?

A defense-in-depth approach to debugging uses multiple validation layers and stack-trace instrumentation to investigate bugs, ensuring structured data tracing and preventing regression through source-level fixes with validated tests.

How do I debug a failing test across different software components?

Debug a failing test by tracing structured data across software components, documenting the root cause, performing pattern analysis, and validating source-level fixes with tests to ensure clear traceability.

What is the best way to structure a debugging workflow for unexpected behavior?

The best way to structure debugging is a phase-driven methodology: Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation, ensuring evidence-driven decision making for unexpected behavior.

When should I use stack-trace instrumentation for bug investigation?

Use stack-trace instrumentation during bug investigation to improve observability and gather evidence, enabling structured data tracing that targets the original trigger of test failures or unexpected software behavior.

Can I use this systematic debugging process for any type of software bug?

Yes, this systematic debugging process targets any bug, test failure, or unexpected behavior across software components, requiring evidence gathering and phased analysis to implement validated source-level fixes.