Initial commit

skills/smart-debugging/reference/INDEX.md

@@ -0,0 +1,56 @@
+# Smart Debug Reference
+
+Debugging references and methodologies for systematic error resolution.
+
+## Available References
+
+### [error-patterns-database.md](error-patterns-database.md)
+Complete error pattern catalog with fixes.
+- **Null Pointer Errors** - NoneType, undefined, null reference
+- **Type Errors** - Type mismatch, unsupported operand, conversion failures
+- **Index Errors** - Array bounds, list access, slice errors
+- **Key Errors** - Dictionary key missing, object property undefined
+- **Import Errors** - Module not found, circular imports
+- **Database Errors** - Connection refused, timeout, constraint violations
+- **API Errors** - 400/422/500 responses, contract violations
+- **Concurrency Errors** - Race conditions, deadlocks, async issues
+- **Memory Errors** - Out of memory, memory leaks
+- **Performance Errors** - Slow queries, N+1 problems, inefficient algorithms
+
+### [stack-trace-patterns.md](stack-trace-patterns.md)
+Stack trace reading and analysis guide.
+- Python stack traces (Traceback format)
+- JavaScript/TypeScript stack traces (Error.stack format)
+- Java stack traces (Exception format)
+- Identifying root file vs. propagation
+- Filtering stdlib and third-party frames
+- Understanding async stack traces
+- Reading minified stack traces
+- Source map integration
+
+### [rca-methodology.md](rca-methodology.md)
+Root cause analysis methodologies.
+- **5 Whys** - Iterative questioning to root cause
+- **Timeline Analysis** - Chronological event reconstruction
+- **Fishbone Diagram** - Ishikawa cause categorization
+- **Fault Tree Analysis** - Logic diagram of failure paths
+- **Change Analysis** - Recent deployments and config changes
+- **Comparative Analysis** - Working vs. broken environments
+- **Reproducibility Testing** - Isolation of causal factors
+
+### [fix-generation-patterns.md](fix-generation-patterns.md)
+Code fix patterns for common errors.
+- Null check patterns (guard clauses, optional chaining)
+- Type validation patterns (isinstance, type hints)
+- Error handling patterns (try-catch, error boundaries)
+- Input validation patterns (Pydantic, zod)
+- Defensive programming patterns
+- Fail-fast vs. graceful degradation
+- Error recovery strategies
+
+## Quick Reference
+
+**Need error patterns?** → [error-patterns-database.md](error-patterns-database.md)
+**Need stack trace help?** → [stack-trace-patterns.md](stack-trace-patterns.md)
+**Need RCA methods?** → [rca-methodology.md](rca-methodology.md)
+**Need fix patterns?** → [fix-generation-patterns.md](fix-generation-patterns.md)