# Debug Session

> Document debugging sessions with hypothesis tracking and knowledge base

- Skill: `manastalukdar/debug-session` (Agent Skill)
- Install (CLI): `npx skillmds@latest add manastalukdar/debug-session`
- Raw SKILL.md: https://api.skillmd.com/api/skills/manastalukdar/debug-session/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: manastalukdar (https://skillmd.com/u/manastalukdar)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/manastalukdar/debug-session

---


# 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

**Expected range**: 150–1,200 tokens (initial), 50 tokens (session update)

**Caching**: Caches current debug session in `.claude/cache/debug-session/current.json` for 7 days.

**Early exit**: Returns immediately for session updates, skipping full re-analysis.

**Patterns used**: Grep-before-Read, early exit, caching, progressive disclosure