What information do I need to provide to start a debug session?

The skill will guide you through gathering expected behavior, actual behavior, error messages, timelines, and reproduction steps.

How does the subagent isolation work?

When you invoke the skill, it spawns a fresh agent with a full 200k context window dedicated specifically to investigating that single bug, keeping your main agent lean.

Does gsd-debug automatically apply fixes to my code?

It focuses on finding the root cause first. Once identified, it offers options to fix it immediately, plan a fix, or allow for manual intervention.

What is the primary benefit of using gsd-debug?

It provides a structured, scientific approach to debugging while using subagents to prevent your main conversation context from being overwhelmed by large file reads.

Can I resume a debugging session after restarting Claude Code?

Yes, gsd-debug saves all session data to the .planning/debug/ directory, allowing you to pick up exactly where the investigation left off.

Systematic Debugging Workflow

Name: Systematic Debugging Workflow
Author: NUbivek

byNUbivek

0•

Developer Tools

Automates systematic, state-persistent debugging using the scientific method to isolate and resolve complex software issues.

The gsd-debug skill provides a rigorous framework for investigating software bugs by implementing the scientific method within Claude Code. It addresses the common problem of context exhaustion by spawning specialized subagents for deep investigation, allowing for extensive file reading and hypothesis testing without cluttering the main conversation. By maintaining persistent state in the .planning/debug directory, it ensures that debugging sessions can be resumed across context resets, providing a reliable audit trail of symptoms, evidence, and root cause analysis.

Key Features

01Subagent isolation to preserve the primary interaction's context window

020 GitHub stars

03Scientific method-based debugging workflow with hypothesis testing

04Persistent session state saved to markdown for context-independent recovery

05Automated checkpoint management for human-in-the-loop verification

06Structured symptom gathering including expected vs. actual behavior

Use Cases

01Managing long-running debugging sessions that require context resets

02Investigating complex logic errors that span across multiple repository files

03Isolating heavy investigation tasks to maintain agent performance during chat

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nubivek/searchbar3 gsd-debug

For use in Claude.ai and ChatGPT