debug-assistant

Intelligent Debugging Helper

Advanced debugging assistant that analyzes errors, suggests fixes, traces root causes, and sets up debugging environments.

Purpose

• Analyze error logs and stack traces
• Suggest fixes based on error patterns
• Set up debugging environments
• Generate reproduction steps
• Track down root causes with specialized agents

Workflow

Step 1: Error Input

1. STOP → "How would you like to provide the error?"

   1. Paste error message/stack trace
   2. Point to log file
   3. Describe the issue
   4. Run failing command
   5. Analyze recent crashes
   
   Choose method (1-5):
   

2. Context Gathering

   • STOP → "When did this error start? (timestamp/commit/today):"
   • STOP → "Is it reproducible? (always/sometimes/once):"
   • STOP → "What were you doing when it occurred?:"

Step 2: Error Analysis

1. Parse Error Information

   // Extract key information
   const errorInfo = {
     type: "TypeError",
     message: "Cannot read property 'x' of undefined",
     file: "src/components/UserList.jsx",
     line: 45,
     column: 12,
     stack: [...],
     timestamp: "2024-01-15T10:30:00Z"
   };
   

2. Categorize Error Type

   error_categories:
     - Runtime Errors:
       - TypeError
       - ReferenceError
       - RangeError
     - Async Errors:
       - Promise rejection
       - Callback errors
       - Race conditions
     - Network Errors:
       - Connection refused
       - Timeout
       - CORS issues
     - Build Errors:
       - Compilation failure
       - Module not found
       - Syntax errors
   

3. Deploy Analysis Agents

   • debugger: Deep error analysis
   • backend-architect: System-level debugging
   • test-automator: Create reproduction test
   • performance-engineer: Performance-related issues

Step 3: Root Cause Analysis

1. Trace Error Source

   # Git blame to find when introduced
   git blame -L 40,50 src/components/UserList.jsx
   
   # Check recent changes
   git log -p --since="2 days ago" src/components/UserList.jsx