debug-sessionlisted

# Debug Session Documentation I'll create structured documentation for your debugging session to build a knowledge base and track your investigation process. **Based on session management patterns:** - Create structured debug logs in `.claude/debugging/` - Hypothesis tracking with test results - Solution documentation - Timeline of investigation - Knowledge base building for future reference **Arguments:** `$ARGUMENTS` - session name or issue description --- ## Token Optimization This skill uses efficient patterns to minimize token consumption while maintaining comprehensive debugging session documentation. ### Optimization Strategies #### 1. Session State Caching (Saves 600 tokens per invocation) Cache current session metadata to avoid repeated file operations: ```bash CACHE_FILE=".claude/cache/debug-session/current.json" CACHE_TTL=3600 # 1 hour mkdir -p .claude/cache/debug-session if [ -f "$CACHE_FILE" ]; then CACHE_AGE=$(($(date +%s) - $(stat -c %Y "$CACHE_FILE" 2>/dev/null || stat -f %m "$CACHE_FILE" 2>/dev/null))) if [ $CACHE_AGE -lt $CACHE_TTL ]; then # Use cached session info SESSION_NAME=$(jq -r '.name' "$CACHE_FILE") SESSION_FILE=$(jq -r '.file' "$CACHE_FILE") SESSION_STATUS=$(jq -r '.status' "$CACHE_FILE") echo "Using cached session: $SESSION_NAME (status: $SESSION_STATUS)" SKIP_FULL_INIT="true" fi fi ``` **Savings:** 600 tokens when cache valid (no directory scanning, no file reads) #### 2