gsd-debug

Persist debugging progress and hypotheses across AI context resets.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill gsd-debug-pear-commerce
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-debug
Source: https://github.com/Pear-Commerce/pear-ai-skills/tree/main/skills/gsd-debug
Command: npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill gsd-debug-pear-commerce

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about gsd-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save debugging progress when an AI assistant context resets?

To save debugging progress across context resets, you need a persistent state mechanism that stores hypotheses and checkpoints externally. This skill writes investigation state to a local .planning/debug/ directory, preserving session data for seamless resumption later.

Can I run a long-running software debugging session without consuming the main conversation context?

Yes, you can isolate long-running software debugging sessions by spawning dedicated subagents. These subagents investigate issues independently, keeping the main conversation context free for direct user interaction while diagnostics run.

What is subagent orchestration for multi-session debugging workflows?

Subagent orchestration for multi-session debugging is the process of spawning isolated debugger agents to test hypotheses. It enables thorough investigations across context resets by saving state and using human verification checkpoints for accuracy.

How do I resume a complex production bug investigation after losing context?

You can resume a complex production bug investigation by loading previously saved session state. The skill automatically detects existing debug data in the .planning/debug/ directory and continues the investigation exactly where it left off.

Does this debugging workflow support human verification checkpoints during root cause analysis?

Yes, this debugging workflow supports human verification checkpoints during root cause analysis. It pauses subagent investigation at critical stages, allowing you to verify findings before the session continues across context resets.

What's the best way to trace root cause across multiple debugging sessions without losing hypotheses?

The best way to trace root cause across multiple debugging sessions is using a persistent debug state directory. This approach saves hypotheses and checkpoints externally, eliminating the need to re-explain issues or re-run initial diagnostics.