systematic-debugging

Guide structured four-phase debugging to identify and resolve root causes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/guangtouwangba/weaver --skill systematic-debugging-guangtouwangba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/guangtouwangba/weaver/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/guangtouwangba/weaver --skill systematic-debugging-guangtouwangba

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill prevents wasted time and new bugs by enforcing a structured approach to debugging, ensuring that the root cause of an issue is identified and fixed, rather than just addressing symptoms.

Core Features & Use Cases

  • 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 or when a quick fix seems obvious.
  • Use Case: When a critical API endpoint starts returning errors, this Skill ensures the engineer systematically investigates the underlying cause rather than applying a hasty patch that might fail later or introduce new problems.

Quick Start

Use the systematic-debugging skill to investigate any bug or unexpected behavior you encounter.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a systematic debugging process for finding the root cause of a bug?

A systematic debugging process enforces a structured four-phase methodology—investigation, pattern analysis, hypothesis formation, and implementation—to identify and resolve the fundamental root cause of an issue rather than just treating symptoms.

How do I fix a critical API endpoint error without introducing new bugs?

To fix a critical API endpoint error without introducing new bugs, systematically investigate the data flow and form a hypothesis about the root cause before applying any implementation, resisting the pressure to apply hasty patches.

How do I trace data flow when troubleshooting multi-component system errors?

To trace data flow when troubleshooting multi-component system errors, follow a structured investigation phase that systematically maps data movement across components to identify exact failure points before forming a fix hypothesis.

Why should I avoid quick fixes when resolving unexpected software behavior?

You should avoid quick fixes for unexpected behavior because addressing only the symptoms prevents you from resolving the fundamental root cause, which wastes time and risks introducing new bugs into the system later.

What is the best way to debug under time pressure without applying hasty patches?

The best way to debug under time pressure is to use a methodology with built-in pressure resistance rules, guiding you through pattern analysis and hypothesis formation to ensure fixes target the root cause and resist shortcuts.