What problem does it solve?
This Skill solves the common pain point of losing all debugging progress, hypotheses, and investigation state when an AI assistant's context resets mid-debugging session, eliminating the need to restart time-consuming investigations from scratch.
Core Features & Use Cases
- Persistent Session State: All debug progress, hypotheses, and checkpoints are saved to the .planning/debug/ directory and survive context resets.
- Isolated Subagent Investigation: Spawns dedicated gsd-debugger subagents to investigate issues without consuming main conversation context, enabling thorough, long-running debugging sessions.
- Checkpoint & Continuation Support: Handles human verification checkpoints during investigation and seamlessly continues sessions across context resets using saved state.
- Use Case: For example, if you are debugging a complex production bug that requires multiple sessions to trace root cause, you can resume the investigation exactly where you left off without re-explaining the issue or re-running initial diagnostic steps.
Quick Start
Invoke the gsd-debug skill by mentioning the gsd-debug command followed by a description of the issue you are debugging to start a new persistent investigation session or resume an existing active session if one is available.