Debugging approach

--- model: claude-sonnet-4-0 --- Debug complex issues using specialized debugging agents: [Extended thinking: This tool command leverages the debugger agent with additional support from performance-engineer when performance issues are involved. It provides deep debugging capabilities with root cause analysis.] ## Debugging Approach ### 1. Primary Debug Analysis Use Task tool with subagenttype="debugger" to: - Analyze error messages and stack traces - Identify code paths leading to the issue - Reproduce the problem systematically - Isolate the root cause - Suggest multiple fix approaches Prompt: "Debug issue: $ARGUMENTS. Provide detailed analysis including: 1. Error reproduction steps 2. Root cause identification 3. Code flow analysis leading to the error 4. Multiple solution approaches with trade-offs 5. Recommended fix with implementation details" ### 2. Performance Debugging (if performance-related) If the issue involves performance problems, also use Task tool with subagenttype="performance-engineer" to: - Profile code execution - Identify bottlenecks - Analyze resource usage - Suggest optimization strategies Prompt: "Profile and debug performance issue: $ARGUMENTS. Include: 1. Performance metrics and profiling data 2. Bottleneck identification 3. Resource usage analysis 4. Optimization recommendations 5. Before/after performance projections" ## Debug Output Structure ### Root Cause Analysis - Precise identification of the bug source - Explanation of why the issue occurs - Impact analysis on other components ### Reproduction Guide - Step-by-step reproduction instructions - Required environment setup - Test data or conditions needed ### Solution Options 1. Quick Fix - Minimal change to resolve issue - Implementation details - Risk assessment 2. Proper Fix - Best long-term solution - Refactoring requirements - Testing needs 3. Preventive Measures - Avoid similar issues - Code patterns to adopt - Tests to add ### Implementation Guide - Specific code changes needed - Order of operations for the fix - Validation steps Issue to debug: $ARGUMENTS