Debugging

Guide root-cause debugging across multi-component systems using a four-phase workflow.

2|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/NammDev/Goads-Krea --skill debugging-nammdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Debugging
Source: https://github.com/NammDev/Goads-Krea/tree/main/.claude/skills/debugging
Command: npx skills add https://github.com/NammDev/Goads-Krea --skill debugging-nammdev

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Systematic method to ensure root-cause investigation precedes fixes, preventing symptom-based patches and creeping complexity.

Core Features & Use Cases

  • Four-phase framework: Root-cause investigation, pattern analysis, hypothesis testing, and verified implementation.
  • Cross-boundary tracing: Guidance to trace data flow across components to identify the original trigger.
  • Defense-in-depth: Validation across multiple layers (entry, business logic, environment, debugging instrumentation).
  • When to use: For persistent failures, complex bugs, and before declaring work complete.

Quick Start

Follow the four-phase debugging process to identify root causes before applying any fixes.

Frequently Asked Questions about Debugging

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

FAQPage Schema
How do I find the root cause of a persistent failure in a multi-component system?

To find the root cause of a persistent failure, you need a systematic phase-based workflow that traces data flow across components to identify the original trigger before applying any fixes. This method enforces cross-boundary tracing and hypothesis testing to prevent symptom-based patches.

What is the best way to stop applying patchwork fixes when debugging complex bugs?

The best way to stop applying patchwork fixes is to enforce a four-phase debugging workflow: root-cause investigation, pattern analysis, hypothesis testing, and verified implementation. This ensures formal verification and defense-in-depth validation are completed before declaring work done.

How do I trace data flow across components to identify the original trigger of an error?

You trace data flow across components by applying cross-boundary tracing during the root-cause investigation phase. This process tracks the error trigger through multiple system layers, utilizing pattern analysis to pinpoint the exact origin before hypothesis testing begins.

When do I need defense-in-depth validation during root-cause debugging?

You need defense-in-depth validation during root-cause debugging when verifying fixes across multiple layers, including entry points, business logic, environment, and debugging instrumentation. It ensures formal verification is satisfied before completion and prevents creeping complexity from inadequate patches.

Does this debugging method work for performance issues or only system errors?

This debugging method works for both performance issues and system errors. It applies to failures across multi-component systems by enforcing a four-phase workflow with traceability, pattern analysis, hypothesis testing, and verification to ensure the root cause is addressed.