debug

name	debug
description	Systematic debugging workflow: reproduce, isolate, fix, and verify.

/debug

Systematic debugging workflow: reproduce, isolate, fix, and verify.

Usage

/debug <issue> [--logs <path>] [--trace]

Arguments

• issue: Description of the bug, error message, or issue number
• --logs <path>: Path to relevant log files
• --trace: Enable verbose tracing during investigation

Instructions

When this skill is invoked:

Agent Behavior

Autonomy:

• Complete the full debug cycle end-to-end
• Make reasonable hypotheses based on error patterns
• Implement and verify fixes without prompting

Thoroughness:

• Exhaust all likely causes before asking for help
• Document findings as you investigate
• Create regression tests for fixed bugs

Methodology:

• Follow scientific method: hypothesize → test → conclude
• Never change multiple things at once
• Always verify the fix resolves the original issue

Debug Process

Phase 1: Understand

1. Gather information:

   • Read error message/stack trace carefully
   • Identify the failing component
   • Note when the issue started (if known)

2. Read relevant code in parallel:

   • File where error occurs
   • Related files (imports, dependencies)
   • Recent changes to affected area