nixos-config/home/common/programs/opencode/commands/smart-debug.md

description, model

description	model
Debug complex issues with root cause analysis and multiple fix approaches	claude-sonnet-4-0

Debug complex issues using specialized debugging agents:

Debugging Approach

1. Primary Debug Analysis

Use Task tool with subagent_type="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 subagent_type="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