4218f8666a
Adds switchable model profiles (quality/balanced/budget) to control which Claude model each agent uses, balancing quality vs token spend. New files: - get-shit-done/references/model-profiles.md - profile lookup table - commands/gsd/set-profile.md - runtime profile switching Updated orchestrators to resolve model before spawning agents: - new-project, new-milestone (7 calls each) - plan-phase (4 calls) - execute-phase (3 calls) - audit-milestone, debug, research-phase, quick (1-2 calls each) - workflows: execute-phase, execute-plan, verify-work, map-codebase Profile stored in .planning/config.json as model_profile. Default: "balanced" (Opus for planning, Sonnet for execution). Closes #160 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
170 lines
3.7 KiB
Markdown
170 lines
3.7 KiB
Markdown
---
|
|
name: gsd:debug
|
|
description: Systematic debugging with persistent state across context resets
|
|
argument-hint: [issue description]
|
|
allowed-tools:
|
|
- Read
|
|
- Bash
|
|
- Task
|
|
- AskUserQuestion
|
|
---
|
|
|
|
<objective>
|
|
Debug issues using scientific method with subagent isolation.
|
|
|
|
**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>
|
|
|
|
<context>
|
|
User's issue: $ARGUMENTS
|
|
|
|
Check for active sessions:
|
|
```bash
|
|
ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
|
|
```
|
|
</context>
|
|
|
|
<process>
|
|
|
|
## 0. Resolve Model Profile
|
|
|
|
Read model profile for agent spawning:
|
|
|
|
```bash
|
|
MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
|
|
```
|
|
|
|
Default to "balanced" if not set.
|
|
|
|
**Model lookup table:**
|
|
|
|
| Agent | quality | balanced | budget |
|
|
|-------|---------|----------|--------|
|
|
| gsd-debugger | opus | sonnet | sonnet |
|
|
|
|
Store resolved model for use in Task calls below.
|
|
|
|
## 1. Check Active Sessions
|
|
|
|
If active sessions exist AND no $ARGUMENTS:
|
|
- List sessions with status, hypothesis, next action
|
|
- User picks number to resume OR describes new issue
|
|
|
|
If $ARGUMENTS provided OR user describes new issue:
|
|
- Continue to symptom gathering
|
|
|
|
## 2. Gather Symptoms (if new issue)
|
|
|
|
Use AskUserQuestion 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
|
|
<objective>
|
|
Investigate issue: {slug}
|
|
|
|
**Summary:** {trigger}
|
|
</objective>
|
|
|
|
<symptoms>
|
|
expected: {expected}
|
|
actual: {actual}
|
|
errors: {errors}
|
|
reproduction: {reproduction}
|
|
timeline: {timeline}
|
|
</symptoms>
|
|
|
|
<mode>
|
|
symptoms_prefilled: true
|
|
goal: find_and_fix
|
|
</mode>
|
|
|
|
<debug_file>
|
|
Create: .planning/debug/{slug}.md
|
|
</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
|
|
- 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
|
|
<objective>
|
|
Continue debugging {slug}. Evidence is in the debug file.
|
|
</objective>
|
|
|
|
<prior_state>
|
|
Debug file: @.planning/debug/{slug}.md
|
|
</prior_state>
|
|
|
|
<checkpoint_response>
|
|
**Type:** {checkpoint_type}
|
|
**Response:** {user_response}
|
|
</checkpoint_response>
|
|
|
|
<mode>
|
|
goal: find_and_fix
|
|
</mode>
|
|
```
|
|
|
|
```
|
|
Task(
|
|
prompt=continuation_prompt,
|
|
subagent_type="gsd-debugger",
|
|
model="{debugger_model}",
|
|
description="Continue debug {slug}"
|
|
)
|
|
```
|
|
|
|
</process>
|
|
|
|
<success_criteria>
|
|
- [ ] Active sessions checked
|
|
- [ ] Symptoms gathered (if new)
|
|
- [ ] gsd-debugger spawned with context
|
|
- [ ] Checkpoints handled correctly
|
|
- [ ] Root cause confirmed before fixing
|
|
</success_criteria>
|