root-cause-analyzer-quickstart

Root Cause Analyzer - Quick Start Guide

🚀 Quick Usage

Using the Skill (Easiest)

# Interactive mode - you'll be prompted for details
/reverse-engineer-debug

# Direct with issue description
/reverse-engineer-debug "Users getting 500 errors on checkout after deployment"

Using Task Tool (Advanced)

Task({
  subagent_type: "root-cause-analyzer",
  description: "Debug timeout issue",
  prompt: "Investigate why API calls timeout after 30s. Started yesterday after updating SDK."
})

📝 What to Provide

For best results, include:

• ✅ Error message (exact text)
• ✅ When it started (deployment, change, etc.)
• ✅ How often (always, intermittent, %)
• ✅ Where (production, staging, local)
• ✅ What changed (code, config, dependencies)

📊 What You Get

The agent provides:

1. Executive Summary - Quick overview
2. Investigation Trail - What was checked and why
3. Root Cause - The real problem (not symptoms)
4. Solution - How to fix it properly
5. Prevention - How to avoid it in the future
6. Code References - Exact file:line locations

🎯 Example Session

You: /reverse-engineer-debug "Memory leak causing crashes after 2 hours"

Agent:
# Root Cause Analysis Report

## Executive Summary
- **Problem**: Application exhausts memory and crashes
- **Root Cause**: Event listeners accumulate without cleanup
- **Location**: src/components/Dashboard.jsx:45
- **Fix**: Add cleanup in componentWillUnmount
- **Priority**: Critical

## Investigation Process
1. Profiled memory growth → confirmed leak
2. Tracked object retention → found event listeners
3. Analyzed component lifecycle → missing cleanup
4. Validated with heap snapshot → confirmed cause

## Root Cause
Event listeners registered in componentDidMount but never removed.
Each render adds new listeners without removing old ones.

## Solution
```javascript
componentWillUnmount() {
  window.removeEventListener('resize', this.handleResize);
  eventBus.off('update', this.handleUpdate);
}

Prevention

• Add memory profiling to CI/CD
• Use linter rules for listener cleanup
• Add test for component unmount behavior