Debug Mode Skill
Specialized workflows for Debug Mode: hypothesis generation, log instrumentation, runtime analysis, and targeted fixes.
When to Use
Use this skill when:
- •Debugging tricky bugs that are hard to reproduce
- •Investigating regressions
- •Analyzing performance issues
- •Troubleshooting race conditions
- •Standard agent interactions aren't working
Debug Mode Workflow
1. Exploration and Hypothesis
Agent will:
- •Explore relevant code paths
- •Generate hypotheses about root causes
- •Identify potential failure points
- •Plan instrumentation strategy
2. Instrumentation
Agent adds:
- •Log statements at key points
- •State tracking (variables, buffers, connections)
- •Timing information
- •Error condition checks
3. Reproduction
You provide:
- •Detailed reproduction steps
- •Expected vs actual behavior
- •Error messages and stack traces
- •Context about when bug occurs
4. Analysis
Agent analyzes:
- •Collected logs
- •State transitions
- •Timing patterns
- •Error conditions
5. Fix
Agent makes:
- •Targeted fix based on evidence
- •Minimal changes to address root cause
- •Verification of fix
- •Cleanup of instrumentation
Best Practices
- •Provide detailed context: More information = better hypotheses
- •Reproduce consistently: Follow steps exactly
- •Multiple reproductions: For intermittent bugs
- •Review fixes: Ensure root cause addressed
- •Clean up: Remove instrumentation after fix
Related Resources
- •Rule:
.cursor/rules/agent-modes.mdc - •Command:
/debug - •Agent:
.cursor/skills/debug-mode/agents/debug-specialist.md