Prompt file imported from AnasShahid/vimsy_lead_generation (.windsurf/workflows/gsd-debug.md). Fill in {{SLUG}} before use. Copyright stays with the author.

/gsd-debug [issue description]

Name: gsd-debug
Author: AnasShahid

Systematic debugging with persistent state. Survives /clear — run /gsd-debug with no args to resume.

Usage:

/gsd-debug "login button doesn't work" — Start new session
/gsd-debug — Resume active session

Check for Active Session

ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -1

If active session exists and no new description provided → resume that session.

Start New Session

Step 1: Create Debug File

mkdir -p .planning/debug
SLUG=$(echo "$DESCRIPTION" | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd 'a-z0-9-' | head -c 50)
DEBUG_FILE=".planning/debug/{{SLUG}}.md"

Create initial file:

# Debug: [Issue Description]

**Started:** [timestamp]
**Status:** investigating

## Symptoms

[To be gathered]

## Evidence Collected

[To be gathered]

## Hypotheses

[To be formed]

## Timeline

| Time | Action | Result |
|------|--------|--------|

## Resolution

**Root cause:** TBD
**Fix:** TBD

Step 2: Gather Symptoms

Use @gsd-debugger methodology. Ask adaptive questions:

For UI issues:

What's expected vs actual?
Consistent or intermittent?
Any console errors?

For API issues:

What endpoint/method?
Request/response details?
Error messages?

For Build issues:

What command fails?
Error message?
Recent changes?

Update debug file with symptoms.

Step 3: Collect Evidence

Gather concrete data:

# Recent changes
git log --oneline -10

# Error logs
cat [log file] | tail -50

# File state
cat [relevant file]

Update debug file with evidence.

Step 4: Form Hypotheses

Based on evidence, form testable hypotheses:

### Hypothesis 1: [Specific claim]

**Evidence supporting:** [what points to this]
**Evidence against:** [what contradicts]
**Test:** [how to verify/falsify]
**Status:** testing

Step 5: Test Hypotheses

For each hypothesis:

Make ONE change
Observe result
Record outcome
Update hypothesis status

**Result:** [confirmed | rejected]
**What happened:** [details]

Step 6: Resolution

When fix found:

## Resolution

**Root cause:** [what caused it]
**Fix:** [what was done]
**Commits:** [hashes]
**Prevention:** [how to prevent recurrence]

Step 7: Archive

mkdir -p .planning/debug/resolved
mv ".planning/debug/{{SLUG}}.md" ".planning/debug/resolved/{{SLUG}}.md"
git add ".planning/debug/resolved/{{SLUG}}.md"
git commit -m "docs: resolve debug session - [slug]"

Resume Session

When resuming (no description provided):

Read the active debug file
Show current status:

## Resuming Debug Session

**Issue:** [description]
**Status:** [status]
**Last action:** [from timeline]

### Current Hypothesis

[Active hypothesis details]

### Next Step

[What to test next]

Continue from where left off

Context Reset Handling

The debug file is the persistent state. After /clear:

/gsd-debug

This will:

Find the active debug file
Load all context
Show summary
Continue investigation

Success Criteria

# /gsd-debug [issue description] Systematic debugging with persistent state. Survives `/clear` — run `/gsd-debug` with no args to resume. **Usage:** - `/gsd-debug "login button doesn't work"` — Start new session - `/gsd-debug` — Resume active session ## Check for Active Session ```bash ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -1 ``` If active session exists and no new description provided → resume that session. ## Start New Session ### Step 1: Create Debug File ```bash mkdir -p .planning/debug SLUG=$(echo "$DESCRIPTION" | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd 'a-z0-9-' | head -c 50) DEBUG_FILE=".planning/debug/{{SLUG}}.md" ``` Create initial file: ```markdown # Debug: [Issue Description] **Started:** [timestamp] **Status:** investigating ## Symptoms [To be gathered] ## Evidence Collected [To be gathered] ## Hypotheses [To be formed] ## Timeline | Time | Action | Result | |------|--------|--------| ## Resolution **Root cause:** TBD **Fix:** TBD ``` ### Step 2: Gather Symptoms Use @gsd-debugger methodology. Ask adaptive questions: **For UI issues:** - What's expected vs actual? - Consistent or intermittent? - Any console errors? **For API issues:** - What endpoint/method? - Request/response details? - Error messages? **For Build issues:** - What command fails? - Error message? - Recent changes? Update debug file with symptoms. ### Step 3: Collect Evidence Gather concrete data: ```bash # Recent changes git log --oneline -10 # Error logs cat [log file] | tail -50 # File state cat [relevant file] ``` Update debug file with evidence. ### Step 4: Form Hypotheses Based on evidence, form testable hypotheses: ```markdown ### Hypothesis 1: [Specific claim] **Evidence supporting:** [what points to this] **Evidence against:** [what contradicts] **Test:** [how to verify/falsify] **Status:** testing ``` ### Step 5: Test Hypotheses For each hypothesis: 1. Make ONE change 2. Observe result 3. Record outcome 4. Update hypothesis status ```markdown **Result:** [confirmed | rejected] **What happened:** [details] ``` ### Step 6: Resolution When fix found: ```markdown ## Resolution **Root cause:** [what caused it] **Fix:** [what was done] **Commits:** [hashes] **Prevention:** [how to prevent recurrence] ``` ### Step 7: Archive ```bash mkdir -p .planning/debug/resolved mv ".planning/debug/{{SLUG}}.md" ".planning/debug/resolved/{{SLUG}}.md" git add ".planning/debug/resolved/{{SLUG}}.md" git commit -m "docs: resolve debug session - [slug]" ``` ## Resume Session When resuming (no description provided): 1. Read the active debug file 2. Show current status: ``` ## Resuming Debug Session **Issue:** [description] **Status:** [status] **Last action:** [from timeline] ### Current Hypothesis [Active hypothesis details] ### Next Step [What to test next] ``` 3. Continue from where left off ## Context Reset Handling The debug file is the persistent state. After `/clear`: ``` /gsd-debug ``` This will: - Find the active debug file - Load all context - Show summary - Continue investigation ## Success Criteria - [ ] Symptoms documented - [ ] Evidence collected - [ ] Hypotheses formed and tested - [ ] Root cause identified - [ ] Fix verified - [ ] Session archived

{ "prompt": "# /gsd-debug [issue description]\n\nSystematic debugging with persistent state. Survives `/clear` — run `/gsd-debug` with no args to resume.\n\n**Usage:** \n- `/gsd-debug \"login button doesn't work\"` — Start new session\n- `/gsd-debug` — Resume active session\n\n## Check for Active Session\n\n```bash\nls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -1\n```\n\nIf active session exists and no new description provided → resume that session.\n\n## Start New Session\n\n### Step 1: Create Debug File\n\n```bash\nmkdir -p .planning/debug\nSLUG=$(echo \"$DESCRIPTION\" | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd 'a-z0-9-' | head -c 50)\nDEBUG_FILE=\".planning/debug/{{SLUG}}.md\"\n```\n\nCreate initial file:\n\n```markdown\n# Debug: [Issue Description]\n\n**Started:** [timestamp]\n**Status:** investigating\n\n## Symptoms\n\n[To be gathered]\n\n## Evidence Collected\n\n[To be gathered]\n\n## Hypotheses\n\n[To be formed]\n\n## Timeline\n\n| Time | Action | Result |\n|------|--------|--------|\n\n## Resolution\n\n**Root cause:** TBD\n**Fix:** TBD\n```\n\n### Step 2: Gather Symptoms\n\nUse @gsd-debugger methodology. Ask adaptive questions:\n\n**For UI issues:**\n- What's expected vs actual?\n- Consistent or intermittent?\n- Any console errors?\n\n**For API issues:**\n- What endpoint/method?\n- Request/response details?\n- Error messages?\n\n**For Build issues:**\n- What command fails?\n- Error message?\n- Recent changes?\n\nUpdate debug file with symptoms.\n\n### Step 3: Collect Evidence\n\nGather concrete data:\n\n```bash\n# Recent changes\ngit log --oneline -10\n\n# Error logs\ncat [log file] | tail -50\n\n# File state\ncat [relevant file]\n```\n\nUpdate debug file with evidence.\n\n### Step 4: Form Hypotheses\n\nBased on evidence, form testable hypotheses:\n\n```markdown\n### Hypothesis 1: [Specific claim]\n\n**Evidence supporting:** [what points to this]\n**Evidence against:** [what contradicts]\n**Test:** [how to verify/falsify]\n**Status:** testing\n```\n\n### Step 5: Test Hypotheses\n\nFor each hypothesis:\n1. Make ONE change\n2. Observe result\n3. Record outcome\n4. Update hypothesis status\n\n```markdown\n**Result:** [confirmed | rejected]\n**What happened:** [details]\n```\n\n### Step 6: Resolution\n\nWhen fix found:\n\n```markdown\n## Resolution\n\n**Root cause:** [what caused it]\n**Fix:** [what was done]\n**Commits:** [hashes]\n**Prevention:** [how to prevent recurrence]\n```\n\n### Step 7: Archive\n\n```bash\nmkdir -p .planning/debug/resolved\nmv \".planning/debug/{{SLUG}}.md\" \".planning/debug/resolved/{{SLUG}}.md\"\ngit add \".planning/debug/resolved/{{SLUG}}.md\"\ngit commit -m \"docs: resolve debug session - [slug]\"\n```\n\n## Resume Session\n\nWhen resuming (no description provided):\n\n1. Read the active debug file\n2. Show current status:\n\n```\n## Resuming Debug Session\n\n**Issue:** [description]\n**Status:** [status]\n**Last action:** [from timeline]\n\n### Current Hypothesis\n\n[Active hypothesis details]\n\n### Next Step\n\n[What to test next]\n```\n\n3. Continue from where left off\n\n## Context Reset Handling\n\nThe debug file is the persistent state. After `/clear`:\n\n```\n/gsd-debug\n```\n\nThis will:\n- Find the active debug file\n- Load all context\n- Show summary\n- Continue investigation\n\n## Success Criteria\n\n- [ ] Symptoms documented\n- [ ] Evidence collected\n- [ ] Hypotheses formed and tested\n- [ ] Root cause identified\n- [ ] Fix verified\n- [ ] Session archived", "variables": [ "SLUG" ], "notes": "Systematic debugging with persistent state across context resets", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/AnasShahid/vimsy_lead_generation", "path": ".windsurf/workflows/gsd-debug.md", "ref": "ce6e48c3b5e6e9bb7710097f17ba74c40c4acc2f", "url": "https://github.com/AnasShahid/vimsy_lead_generation/blob/ce6e48c3b5e6e9bb7710097f17ba74c40c4acc2f/.windsurf/workflows/gsd-debug.md", "key": "AnasShahid/vimsy_lead_generation/.windsurf/workflows/gsd-debug.md" } } }

gsd-debug

About