fix: use general-purpose agent for MCP-dependent subagents

Custom subagents cannot access MCP tools due to Claude Code bug #13898.
This affects gsd-phase-researcher, gsd-project-researcher, and gsd-planner
which need Context7 for documentation lookups.

Fix: Switch to general-purpose agent (which has MCP access) and have it
read the agent instruction file as its first action. The specialized
behavior comes from the prompt, not the agent definition.

Closes #161

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
2026-01-22 10:58:08 -06:00
parent a3a16be296
commit 314916bae9
3 changed files with 22 additions and 18 deletions

View File

@@ -439,7 +439,8 @@ Display spawning indicator:
Spawn 4 parallel gsd-project-researcher agents with rich context:
```
Task(prompt="
Task(prompt="First, read ~/.claude/agents/gsd-project-researcher.md for your role and instructions.
<research_type>
Project Research — Stack dimension for [domain].
</research_type>
@@ -476,9 +477,10 @@ Your STACK.md feeds into roadmap creation. Be prescriptive:
Write to: .planning/research/STACK.md
Use template: ~/.claude/get-shit-done/templates/research-project/STACK.md
</output>
", subagent_type="gsd-project-researcher", model="{researcher_model}", description="Stack research")
", subagent_type="general-purpose", model="{researcher_model}", description="Stack research")
Task(prompt="First, read ~/.claude/agents/gsd-project-researcher.md for your role and instructions.
Task(prompt="
<research_type>
Project Research — Features dimension for [domain].
</research_type>
@@ -515,9 +517,10 @@ Your FEATURES.md feeds into requirements definition. Categorize clearly:
Write to: .planning/research/FEATURES.md
Use template: ~/.claude/get-shit-done/templates/research-project/FEATURES.md
</output>
", subagent_type="gsd-project-researcher", model="{researcher_model}", description="Features research")
", subagent_type="general-purpose", model="{researcher_model}", description="Features research")
Task(prompt="First, read ~/.claude/agents/gsd-project-researcher.md for your role and instructions.
Task(prompt="
<research_type>
Project Research — Architecture dimension for [domain].
</research_type>
@@ -554,9 +557,10 @@ Your ARCHITECTURE.md informs phase structure in roadmap. Include:
Write to: .planning/research/ARCHITECTURE.md
Use template: ~/.claude/get-shit-done/templates/research-project/ARCHITECTURE.md
</output>
", subagent_type="gsd-project-researcher", model="{researcher_model}", description="Architecture research")
", subagent_type="general-purpose", model="{researcher_model}", description="Architecture research")
Task(prompt="First, read ~/.claude/agents/gsd-project-researcher.md for your role and instructions.
Task(prompt="
<research_type>
Project Research — Pitfalls dimension for [domain].
</research_type>
@@ -593,7 +597,7 @@ Your PITFALLS.md prevents mistakes in roadmap/planning. For each pitfall:
Write to: .planning/research/PITFALLS.md
Use template: ~/.claude/get-shit-done/templates/research-project/PITFALLS.md
</output>
", subagent_type="gsd-project-researcher", model="{researcher_model}", description="Pitfalls research")
", subagent_type="general-purpose", model="{researcher_model}", description="Pitfalls research")
```
After all 4 agents complete, spawn synthesizer to create SUMMARY.md:

View File

@@ -206,8 +206,8 @@ Write research findings to: {phase_dir}/{phase}-RESEARCH.md
```
Task(
prompt=research_prompt,
subagent_type="gsd-phase-researcher",
prompt="First, read ~/.claude/agents/gsd-phase-researcher.md for your role and instructions.\n\n" + research_prompt,
subagent_type="general-purpose",
model="{researcher_model}",
description="Research Phase {phase}"
)
@@ -315,8 +315,8 @@ Before returning PLANNING COMPLETE:
```
Task(
prompt=filled_prompt,
subagent_type="gsd-planner",
prompt="First, read ~/.claude/agents/gsd-planner.md for your role and instructions.\n\n" + filled_prompt,
subagent_type="general-purpose",
model="{planner_model}",
description="Plan Phase {phase}"
)
@@ -445,8 +445,8 @@ Return what changed.
```
Task(
prompt=revision_prompt,
subagent_type="gsd-planner",
prompt="First, read ~/.claude/agents/gsd-planner.md for your role and instructions.\n\n" + revision_prompt,
subagent_type="general-purpose",
model="{planner_model}",
description="Revise Phase {phase} plans"
)

View File

@@ -148,8 +148,8 @@ Write to: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
```
Task(
prompt=filled_prompt,
subagent_type="gsd-phase-researcher",
prompt="First, read ~/.claude/agents/gsd-phase-researcher.md for your role and instructions.\n\n" + filled_prompt,
subagent_type="general-purpose",
model="{researcher_model}",
description="Research Phase {phase}"
)
@@ -182,8 +182,8 @@ Research file: @.planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
```
Task(
prompt=continuation_prompt,
subagent_type="gsd-phase-researcher",
prompt="First, read ~/.claude/agents/gsd-phase-researcher.md for your role and instructions.\n\n" + continuation_prompt,
subagent_type="general-purpose",
model="{researcher_model}",
description="Continue research Phase {phase}"
)