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
- Exploration and Hypothesis
Agent will:
-
Explore relevant code paths
-
Generate hypotheses about root causes
-
Identify potential failure points
-
Plan instrumentation strategy
- Instrumentation
Agent adds:
-
Log statements at key points
-
State tracking (variables, buffers, connections)
-
Timing information
-
Error condition checks
- Reproduction
You provide:
-
Detailed reproduction steps
-
Expected vs actual behavior
-
Error messages and stack traces
-
Context about when bug occurs
- Analysis
Agent analyzes:
-
Collected logs
-
State transitions
-
Timing patterns
-
Error conditions
- 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