<cursor_skill_adapter>

A. Skill Invocation

• This skill is invoked when the user mentions gsd-debug or describes a task matching this skill.
• Treat all user text after the skill mention as {{GSD_ARGS}}.
• If no arguments are present, treat {{GSD_ARGS}} as empty.

B. User Prompting

When the workflow needs user input, prompt the user conversationally:

• Present options as a numbered list in your response text
• Ask the user to reply with their choice
• For multi-select, ask for comma-separated numbers

C. Tool Usage

Use these Cursor tools when executing GSD workflows:

• Shell for running commands (terminal operations)
• StrReplace for editing existing files
• Read, Write, Glob, Grep, Task, WebSearch, WebFetch, TodoWrite as needed

D. Subagent Spawning

When the workflow needs to spawn a subagent:

• Use Task(subagent_type="generalPurpose", ...)
• The model parameter maps to Cursor's model options (e.g., "fast") </cursor_skill_adapter>

Orchestrator role: Gather symptoms, spawn gsd-debugger agent, handle checkpoints, spawn continuations.

Why subagent: Investigation burns context fast (reading files, forming hypotheses, testing). Fresh 200k context per investigation. Main context stays lean for user interaction. </objective>

<available_agent_types> Valid GSD subagent types (use exact names — do not fall back to 'general-purpose'):

• gsd-debugger — Diagnoses and fixes issues </available_agent_types>

Check for active sessions:

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

0. Initialize Context

bash
1INIT=$(node ".cursor/get-shit-done/bin/gsd-tools.cjs" state load)
2if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi

Extract commit_docs from init JSON. Resolve debugger model:

bash
1debugger_model=$(node ".cursor/get-shit-done/bin/gsd-tools.cjs" resolve-model gsd-debugger --raw)

1. Check Active Sessions

If active sessions exist AND no {{GSD_ARGS}}:

• List sessions with status, hypothesis, next action
• User picks number to resume OR describes new issue

If {{GSD_ARGS}} provided OR user describes new issue:

• Continue to symptom gathering

2. Gather Symptoms (if new issue)

Use conversational prompting for each:

1. Expected behavior - What should happen?
2. Actual behavior - What happens instead?
3. Error messages - Any errors? (paste or describe)
4. Timeline - When did this start? Ever worked?
5. Reproduction - How do you trigger it?

After all gathered, confirm ready to investigate.

3. Spawn gsd-debugger Agent

Fill prompt and spawn:

markdown
1<objective>
2Investigate issue: {slug}
3
4**Summary:** {trigger}
5</objective>
6
7<symptoms>
8expected: {expected}
9actual: {actual}
10errors: {errors}
11reproduction: {reproduction}
12timeline: {timeline}
13</symptoms>
14
15<mode>
16symptoms_prefilled: true
17goal: find_and_fix
18</mode>
19
20<debug_file>
21Create: .planning/debug/{slug}.md
22</debug_file>

Task(
  prompt=filled_prompt,
  subagent_type="gsd-debugger",
  model="{debugger_model}",
  description="Debug {slug}"
)

4. Handle Agent Return

If ## ROOT CAUSE FOUND:

• Display root cause and evidence summary
• Offer options:
  • "Fix now" - spawn fix subagent
  • "Plan fix" - suggest /gsd-plan-phase --gaps
  • "Manual fix" - done

If ## CHECKPOINT REACHED:

• Present checkpoint details to user
• Get user response
• If checkpoint type is human-verify:
  • If user confirms fixed: continue so agent can finalize/resolve/archive
  • If user reports issues: continue so agent returns to investigation/fixing
• Spawn continuation agent (see step 5)

If ## INVESTIGATION INCONCLUSIVE:

• Show what was checked and eliminated
• Offer options:
  • "Continue investigating" - spawn new agent with additional context
  • "Manual investigation" - done
  • "Add more context" - gather more symptoms, spawn again

5. Spawn Continuation Agent (After Checkpoint)

When user responds to checkpoint, spawn fresh agent:

markdown
1<objective>
2Continue debugging {slug}. Evidence is in the debug file.
3</objective>
4
5<prior_state>
6<files_to_read>
7- .planning/debug/{slug}.md (Debug session state)
8</files_to_read>
9</prior_state>
10
11<checkpoint_response>
12**Type:** {checkpoint_type}
13**Response:** {user_response}
14</checkpoint_response>
15
16<mode>
17goal: find_and_fix
18</mode>

Task(
  prompt=continuation_prompt,
  subagent_type="gsd-debugger",
  model="{debugger_model}",
  description="Continue debug {slug}"
)

<success_criteria>

• Active sessions checked
• Symptoms gathered (if new)
• gsd-debugger spawned with context
• Checkpoints handled correctly
• Root cause confirmed before fixing </success_criteria>