Miguel Palhas
70 lines
1.9 KiB
Markdown
70 lines
1.9 KiB
Markdown
---
|
|
description: Debug complex issues with root cause analysis and multiple fix approaches
|
|
model: 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
|