Where is the debugging state stored?

Session state is persisted in the .planning/debug/ directory as Markdown files, allowing you to resume investigations even after a context reset or tool restart.

What information does the skill collect before starting?

It gathers critical data including expected vs. actual behavior, error logs, timelines, and reproduction steps to ensure the subagent has a clear starting point.

Can I use gsd-debug for any programming language?

Yes, gsd-debug is language-agnostic. it uses a universal scientific method of hypothesis and testing applicable to any software environment.

How does gsd-debug handle context limits?

It spawns isolated subagents with their own 200k context windows, preventing the main conversation from becoming bloated while investigating large files or complex dependencies.

GSD Debug

Name: GSD Debug
Author: fnuAshutosh

byfnuAshutosh

0•

Developer Tools

Conducts systematic, state-persistent debugging using isolated subagents to solve complex software issues without exhausting context limits.

The gsd-debug skill implements a scientific approach to troubleshooting by offloading intensive investigative tasks to specialized subagents. By maintaining persistent state in dedicated planning files, it allows for deep-dive analysis that spans across context resets, ensuring the main Claude interface remains fast and focused. It automates the gathering of symptoms—including expected vs. actual behavior and reproduction steps—and provides structured checkpoints for user feedback, making it an essential tool for resolving stubborn bugs in large, complex codebases.

Key Features

010 GitHub stars

02Scientific debugging workflow with structured symptom gathering

03Human-in-the-loop checkpoints for verification and guidance

04Subagent isolation to preserve the primary context window

05Persistent state tracking across multiple sessions and resets

06Automated root cause analysis and remediation planning

Use Cases

01Standardizing the investigative process for team-based software development

02Managing long-running debugging sessions that exceed standard AI context limits

03Troubleshooting intermittent or complex bugs that require deep file exploration

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fnuashutosh/medimind gsd-debug

For use in Claude.ai and ChatGPT