systematic-debugging

Guide four-phase debugging with root cause analysis and evidence gathering.

375|38|Updated Dec 2, 2025
One-click install
npx skills add https://github.com/CraftOS-dev/CraftBot --skill systematic-debugging-craftos-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/CraftOS-dev/CraftBot/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/CraftOS-dev/CraftBot --skill systematic-debugging-craftos-dev

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 by ensuring that the root cause of any technical issue is identified and fixed, rather than just addressing the immediate symptoms.

Core Features & Use Cases

  • Systematic Four-Phase Process: Guides users through Investigation, Pattern Analysis, Hypothesis, and Implementation.
  • Root Cause Mandate: Emphasizes finding the fundamental issue before applying any fixes.
  • Pressure Resistance: Includes rules and language designed to prevent shortcuts under time pressure.
  • Use Case: When a test fails or an unexpected behavior occurs, use this Skill to systematically diagnose the problem, ensuring a robust solution rather than a quick patch.

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
How do I find the root cause of a bug instead of just fixing symptoms?

To find the root cause of a bug, use a systematic four-phase debugging process: Investigation, Pattern Analysis, Hypothesis, and Implementation. This methodology enforces evidence gathering and data flow tracing to identify the fundamental issue before applying any fixes.

What is the best way to debug complex multi-component system failures?

The best way to debug complex multi-component system failures is following a structured methodology that traces data flows and gathers evidence across components. This systematic process prevents superficial patches by mandating root cause analysis through pattern analysis and hypothesis formation.

How do I stop taking debugging shortcuts when under time pressure?

To stop taking debugging shortcuts under time pressure, apply a systematic debugging methodology with explicit pressure resistance rules. These rules counter common rationalizations, ensuring you complete the investigation and hypothesis phases before attempting an implementation.

When should I use a systematic debugging process for troubleshooting errors?

You should use a systematic debugging process for troubleshooting errors whenever a test fails or unexpected behavior occurs. It ensures you systematically diagnose the problem and implement a robust solution rather than applying a quick patch that might introduce new bugs.

Does this systematic debugging methodology work for tracing data flow in technical issues?

Yes, this systematic debugging methodology works for tracing data flow in technical issues. The investigation phase explicitly includes detailed steps for evidence gathering and data flow tracing to support accurate root cause analysis across complex systems.

What are the limitations of using a systematic debugging process for bug fixing?

A limitation of using a systematic debugging process for bug fixing is that it resists immediate fixes under time pressure, requiring full investigation and hypothesis formation phases. This strict adherence to root cause analysis deliberately prioritizes long-term stability over quick symptom resolution.