2.5 KiB
2.5 KiB
Smart Debug Reference
Debugging references and methodologies for systematic error resolution.
Available References
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 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
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
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 Need stack trace help? → stack-trace-patterns.md Need RCA methods? → rca-methodology.md Need fix patterns? → fix-generation-patterns.md