debugging

Guide root-cause investigation through a four-phase systematic debugging workflow.

Updated Dec 12, 2025
One-click install
npx skills add https://github.com/hungtrandigital/ResidentOne --skill debugging-hungtrandigital
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging
Source: https://github.com/hungtrandigital/ResidentOne/tree/main/0-agents/agents/skills/debugging
Command: npx skills add https://github.com/hungtrandigital/ResidentOne --skill debugging-hungtrandigital

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

A disciplined debugging framework that ensures root-cause investigation before fixes, with defense-in-depth validation and verification.

Core Features & Use Cases

  • Four-phase systematic debugging process
  • Root-cause tracing and evidence gathering
  • Verification before completion

Quick Start

When a bug is detected, start with Phase 1: collect errors and reproduce reliably, then proceed to Phase 2 (pattern analysis).

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 bug instead of applying quick fixes?

Root-cause debugging systematically traces back through error logs, call stacks, and reproduction steps to identify the underlying issue rather than surface symptoms. This Skill enforces a four-phase workflow: collect and reproduce errors, analyze patterns, test hypotheses, then verify the fix before completion.

What's the best way to debug test failures and unexpected behavior?

Systematic debugging applies defense-in-depth validation across entry points, business logic, environment guards, and instrumentation to isolate where failures originate. The four-phase process guides pattern analysis and hypothesis testing to confirm the actual cause.

How do I approach performance issues and integration problems methodically?

Performance and integration debugging starts with reliable reproduction and error collection, then traces backward through call stacks to identify bottlenecks or incompatibilities. Pattern analysis and verification ensure fixes address root causes, not symptoms.

What does defense-in-depth validation mean in debugging?

Defense-in-depth validation checks multiple layers—entry points, business logic, environment configuration, and debug instrumentation—to confirm where a problem actually occurs. This prevents misdiagnosis and ensures fixes target the true root cause.

Why should I verify fixes before considering a bug resolved?

Verification confirms that the fix resolves the root cause and doesn't introduce new issues. This Skill mandates verification as the final phase, ensuring solutions are complete and the underlying problem is genuinely addressed.