Smithery is now a part of Arcade.dev! Read more in our announcement here
Log problems, bugs, and debugging processes with solutions. Use when encountering issues during development, debugging problems, or documenting solutions for future reference...
Record problems, bugs, and debugging processes with structured solutions for future reference.
Use this skill when:
When an issue occurs, document it immediately:
Key information to capture:
Record the debugging process:
Document:
When a solution is found:
Record:
Add the problem-solution entry to the debug log file (.claude/DEBUG_LOG.md):
# Debug Log - VRP Toolkit Project
*Structured record of problems, bugs, and solutions encountered during development.*
## Active Issues 🚧
*Issues not yet resolved or needing follow-up.*
### [Issue Title]
**Date Opened:** YYYY-MM-DD
**Last Updated:** YYYY-MM-DD
**Status:** Investigating / Needs Fix / Waiting
**Problem:**
[Brief description of the problem]
**Symptoms:**
- [Error messages]
- [Unexpected behavior]
**Current Investigation:**
- [Hypotheses being tested]
- [Tests performed]
**Next Steps:**
1. [Action item 1]
2. [Action item 2]
---
## Resolved Issues ✅
*Problems that have been solved.*
### [Issue Title]
**Date Opened:** YYYY-MM-DD
**Date Resolved:** YYYY-MM-DD
**Resolution Time:** [e.g., 2 hours]
**Problem:**
[Brief description of the problem]
**Symptoms:**
- [Error messages]
- [Unexpected behavior]
**Root Cause:**
[The underlying cause of the issue]
**Solution:**
[The fix implemented]
**Prevention:**
[How to prevent similar issues]
**Lessons Learned:**
[Key takeaways from this debugging process]
---
## Common Patterns & Solutions 🔧
*Recurring issues and their solutions for quick reference.*
### Pattern 1: [Pattern Name]
**Symptoms:** [Common symptoms]
**Cause:** [Typical cause]
**Solution:** [Standard solution]
**Example:** [Link to specific resolved issue]
### Pattern 2: [Pattern Name]
**Symptoms:** [Common symptoms]
**Cause:** [Typical cause]
**Solution:** [Standard solution]
**Example:** [Link to specific resolved issue]
### [Brief descriptive title]
**Date Opened:** YYYY-MM-DD
**Last Updated:** YYYY-MM-DD
**Status:** Investigating
**Problem:**
[What were you trying to do when the issue occurred?]
**Symptoms:**
- [Specific error messages with tracebacks]
- [Unexpected output or behavior]
- [What works vs what doesn't]
**Environment:**
- OS: [Operating system]
- Python: [Python version]
- Packages: [Relevant package versions]
- Context: [What part of the project]
**Reproduction Steps:**
1. [Step 1]
2. [Step 2]
3. [Step 3]
**Current Investigation:**
- **Hypothesis 1:** [What you think might be wrong]
- Test: [What test you ran]
- Result: [What happened]
**Next Steps:**
1. [Immediate next action]
2. [Longer-term investigation if needed]
---
### [Brief descriptive title]
**Date Opened:** YYYY-MM-DD
**Date Resolved:** YYYY-MM-DD
**Resolution Time:** [e.g., 45 minutes]
**Problem:**
[What was the problem?]
**Symptoms:**
- [Error messages]
- [Unexpected behavior]
**Root Cause:**
[The actual underlying cause - be specific]
- [Technical details]
- [Why it wasn't obvious]
**Solution:**
[The fix that worked]
- [Code changes made]
- [Configuration updates]
- [Workarounds implemented]
**Prevention:**
[How to prevent this issue in future]
- [Code patterns to avoid]
- [Tests to add]
- [Documentation to update]
**Lessons Learned:**
[Key insights from debugging]
- [What made debugging difficult/easy]
- [Tools or techniques that helped]
- [What to try first next time]
**Files Modified:**
- [path/to/file.py]
- [path/to/config.yaml]
---
update-task-board: Active issues in DEBUG_LOG.md become tasks in CLAUDE.md "Blockers" or "In Progress" sections.
git-log: When fixing bugs documented in DEBUG_LOG.md, reference the issue in commit messages.
build-session-context: Check DEBUG_LOG.md for active issues when starting work.
update-migration-log: Document debugging efforts as part of migration or task completion.
Trigger: ImportError: cannot import name 'RealMap' from 'vrp_toolkit.data'
Debug process:
__init__.py exportsEntry: Document the import error, investigation steps, and solution (adding missing export to __init__.py).
Trigger: ALNS algorithm produces invalid routes
Debug process:
Entry: Document the bug, debugging steps, and fix (correcting index calculation).
Trigger: Matplotlib fails to import on Windows
Debug process:
Entry: Document the platform-specific issue and workaround.
When AI uses this skill, it should:
