feat(02-02): research subagent prompt templates
- Created comprehensive prompts for ecosystem, architecture, pitfalls, standards - Updated workflow with required_reading and concrete Task tool examples - Batch ordering: ecosystem+architecture first, pitfalls+standards second 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
557
get-shit-done/references/research-subagent-prompts.md
Normal file
557
get-shit-done/references/research-subagent-prompts.md
Normal file
@@ -0,0 +1,557 @@
|
|||||||
|
# Research Subagent Prompts
|
||||||
|
|
||||||
|
<overview>
|
||||||
|
Prompt templates for subagents that research domain ecosystems before roadmap creation.
|
||||||
|
|
||||||
|
Each subagent:
|
||||||
|
- Researches ONE category (ecosystem, architecture, pitfalls, or standards)
|
||||||
|
- Writes directly to `.planning/research/{category}.md`
|
||||||
|
- Uses WebSearch and Context7 for current information
|
||||||
|
- Cross-verifies findings with authoritative sources
|
||||||
|
|
||||||
|
These prompts are used by the research-project workflow when spawning Task tool subagents.
|
||||||
|
</overview>
|
||||||
|
|
||||||
|
<ecosystem_subagent_prompt>
|
||||||
|
## Ecosystem Research Subagent
|
||||||
|
|
||||||
|
Use this template for spawning ecosystem research subagents:
|
||||||
|
|
||||||
|
```
|
||||||
|
<subagent_prompt>
|
||||||
|
## Objective
|
||||||
|
Research the library/framework ecosystem for {domain} and write findings to .planning/research/ecosystem.md
|
||||||
|
|
||||||
|
## Domain Context
|
||||||
|
{Paste relevant sections from PROJECT.md describing what's being built}
|
||||||
|
|
||||||
|
## Your Assignment
|
||||||
|
File: .planning/research/ecosystem.md
|
||||||
|
Category: ecosystem
|
||||||
|
Purpose: Map the libraries, frameworks, and tools available for this domain
|
||||||
|
|
||||||
|
## Research Questions
|
||||||
|
Answer these questions through web research:
|
||||||
|
1. What are the go-to libraries for this problem space?
|
||||||
|
2. Which frameworks are actively maintained (commits in last 12 months)?
|
||||||
|
3. What's the "standard stack" that domain experts use?
|
||||||
|
4. What should NOT be hand-rolled because existing solutions exist?
|
||||||
|
5. What are the version requirements and compatibility considerations?
|
||||||
|
|
||||||
|
## Research Requirements
|
||||||
|
|
||||||
|
You MUST use WebSearch and Context7 to get current information.
|
||||||
|
|
||||||
|
For EACH library/tool discovered:
|
||||||
|
1. Verify actively maintained (GitHub commits in last 12 months)
|
||||||
|
2. Get current version number
|
||||||
|
3. Understand when to use vs alternatives
|
||||||
|
4. Find official documentation and getting started guides
|
||||||
|
5. Note any critical dependencies or compatibility issues
|
||||||
|
|
||||||
|
**Search queries to run:**
|
||||||
|
- "{domain} best libraries 2024 2025"
|
||||||
|
- "{domain} framework comparison"
|
||||||
|
- "{specific problem from PROJECT.md} library recommendation"
|
||||||
|
- "{domain} standard stack production"
|
||||||
|
|
||||||
|
**Red flags (reject these):**
|
||||||
|
- No updates in 12+ months
|
||||||
|
- Deprecated or archived repositories
|
||||||
|
- Pre-2023 recommendations without verification
|
||||||
|
|
||||||
|
## Output Format
|
||||||
|
|
||||||
|
Write to .planning/research/ecosystem.md using this structure:
|
||||||
|
|
||||||
|
# Ecosystem: {Domain}
|
||||||
|
|
||||||
|
**Category:** ecosystem
|
||||||
|
**Domain:** {domain}
|
||||||
|
**Researched:** {today's date}
|
||||||
|
**Confidence:** {high | medium | low}
|
||||||
|
|
||||||
|
## Research Summary
|
||||||
|
|
||||||
|
{2-3 sentences on what was found and the recommended direction}
|
||||||
|
|
||||||
|
## Findings
|
||||||
|
|
||||||
|
### {Library/Framework 1}
|
||||||
|
|
||||||
|
{What it is and what it does}
|
||||||
|
|
||||||
|
**Source:** {URL}
|
||||||
|
**Version:** {current version}
|
||||||
|
**Confidence:** {high | medium | low}
|
||||||
|
**Why consider:** {Relevance to project}
|
||||||
|
**Tradeoffs:** {Limitations or considerations}
|
||||||
|
|
||||||
|
### {Library/Framework 2}
|
||||||
|
|
||||||
|
{Same structure}
|
||||||
|
|
||||||
|
{... continue for each significant option ...}
|
||||||
|
|
||||||
|
## Recommendations
|
||||||
|
|
||||||
|
### Use
|
||||||
|
|
||||||
|
- **{Library A}** - {One-line reason, specific use case}
|
||||||
|
- **{Library B}** - {One-line reason, specific use case}
|
||||||
|
|
||||||
|
### Avoid
|
||||||
|
|
||||||
|
- **{Library X}** - {One-line reason}
|
||||||
|
- **Hand-rolling {Y}** - {Existing solution available}
|
||||||
|
|
||||||
|
### Defer Decision
|
||||||
|
|
||||||
|
- **{Topic}** - {Why more investigation needed}
|
||||||
|
|
||||||
|
## Sources
|
||||||
|
|
||||||
|
| Source | Type | Confidence | Last Verified |
|
||||||
|
|--------|------|------------|---------------|
|
||||||
|
| {URL} | {official docs / github / blog} | {high/medium/low} | {today} |
|
||||||
|
|
||||||
|
## Open Questions
|
||||||
|
|
||||||
|
- {Question that couldn't be resolved}
|
||||||
|
- {Question for roadmap planning}
|
||||||
|
|
||||||
|
---
|
||||||
|
*Generated by research-project subagent*
|
||||||
|
*Category: ecosystem*
|
||||||
|
|
||||||
|
## Quality Criteria
|
||||||
|
- Include at least 3-5 library/framework options
|
||||||
|
- Compare options (don't just list them)
|
||||||
|
- Every recommendation has a specific reason
|
||||||
|
- Verify all versions are current
|
||||||
|
- Note what NOT to hand-roll
|
||||||
|
</subagent_prompt>
|
||||||
|
```
|
||||||
|
</ecosystem_subagent_prompt>
|
||||||
|
|
||||||
|
<architecture_subagent_prompt>
|
||||||
|
## Architecture Research Subagent
|
||||||
|
|
||||||
|
Use this template for spawning architecture research subagents:
|
||||||
|
|
||||||
|
```
|
||||||
|
<subagent_prompt>
|
||||||
|
## Objective
|
||||||
|
Research architecture patterns for {domain} projects and write findings to .planning/research/architecture.md
|
||||||
|
|
||||||
|
## Domain Context
|
||||||
|
{Paste relevant sections from PROJECT.md describing what's being built}
|
||||||
|
|
||||||
|
## Your Assignment
|
||||||
|
File: .planning/research/architecture.md
|
||||||
|
Category: architecture
|
||||||
|
Purpose: Document standard project structure and architectural patterns
|
||||||
|
|
||||||
|
## Research Questions
|
||||||
|
Answer these questions through web research:
|
||||||
|
1. How do experts structure projects in this domain?
|
||||||
|
2. What component boundaries work best?
|
||||||
|
3. What patterns prevent common problems?
|
||||||
|
4. How does data flow in typical implementations?
|
||||||
|
5. What directory structure do production projects use?
|
||||||
|
|
||||||
|
## Research Requirements
|
||||||
|
|
||||||
|
You MUST use WebSearch and Context7 to get current information.
|
||||||
|
|
||||||
|
For EACH pattern discovered:
|
||||||
|
1. Find real-world examples (GitHub repos, case studies)
|
||||||
|
2. Understand the tradeoffs
|
||||||
|
3. Note when it applies vs when it doesn't
|
||||||
|
4. Find implementation guidelines
|
||||||
|
|
||||||
|
**Search queries to run:**
|
||||||
|
- "{domain} project structure best practices"
|
||||||
|
- "{domain} architecture patterns"
|
||||||
|
- "{specific problem from PROJECT.md} implementation patterns"
|
||||||
|
- "{domain} component organization"
|
||||||
|
- "{domain} example github repo structure"
|
||||||
|
|
||||||
|
## Output Format
|
||||||
|
|
||||||
|
Write to .planning/research/architecture.md using this structure:
|
||||||
|
|
||||||
|
# Architecture: {Domain}
|
||||||
|
|
||||||
|
**Category:** architecture
|
||||||
|
**Domain:** {domain}
|
||||||
|
**Researched:** {today's date}
|
||||||
|
**Confidence:** {high | medium | low}
|
||||||
|
|
||||||
|
## Research Summary
|
||||||
|
|
||||||
|
{2-3 sentences on recommended architectural approach}
|
||||||
|
|
||||||
|
## Findings
|
||||||
|
|
||||||
|
### Project Structure
|
||||||
|
|
||||||
|
Recommended directory layout:
|
||||||
|
```
|
||||||
|
{concrete directory structure with comments}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Source:** {Reference project or documentation}
|
||||||
|
**Rationale:** {Why this structure works}
|
||||||
|
|
||||||
|
### {Pattern 1 Name}
|
||||||
|
|
||||||
|
**When to use:** {Specific scenarios}
|
||||||
|
**Implementation:** {How to implement}
|
||||||
|
**Example:** {Concrete code example if applicable}
|
||||||
|
**Tradeoffs:** {What you give up}
|
||||||
|
|
||||||
|
### {Pattern 2 Name}
|
||||||
|
|
||||||
|
{Same structure}
|
||||||
|
|
||||||
|
### Data Flow
|
||||||
|
|
||||||
|
{How data moves through the system}
|
||||||
|
|
||||||
|
### Component Boundaries
|
||||||
|
|
||||||
|
{What should be separate vs combined}
|
||||||
|
|
||||||
|
## Recommendations
|
||||||
|
|
||||||
|
### Adopt
|
||||||
|
|
||||||
|
- **{Pattern A}** - {Why it fits this project}
|
||||||
|
- **{Structure B}** - {Why it fits this project}
|
||||||
|
|
||||||
|
### Avoid
|
||||||
|
|
||||||
|
- **{Anti-pattern X}** - {Why it fails}
|
||||||
|
- **{Premature abstraction Y}** - {Why to defer}
|
||||||
|
|
||||||
|
## Sources
|
||||||
|
|
||||||
|
| Source | Type | Confidence | Last Verified |
|
||||||
|
|--------|------|------------|---------------|
|
||||||
|
| {URL} | {official docs / github / tutorial} | {high/medium/low} | {today} |
|
||||||
|
|
||||||
|
## Open Questions
|
||||||
|
|
||||||
|
- {Architecture decision that needs more context}
|
||||||
|
- {Question about project-specific constraints}
|
||||||
|
|
||||||
|
---
|
||||||
|
*Generated by research-project subagent*
|
||||||
|
*Category: architecture*
|
||||||
|
|
||||||
|
## Quality Criteria
|
||||||
|
- Include concrete directory structure
|
||||||
|
- Document at least 2-3 patterns
|
||||||
|
- Every recommendation has specific rationale
|
||||||
|
- Include real example sources
|
||||||
|
- Address data flow and component boundaries
|
||||||
|
</subagent_prompt>
|
||||||
|
```
|
||||||
|
</architecture_subagent_prompt>
|
||||||
|
|
||||||
|
<pitfalls_subagent_prompt>
|
||||||
|
## Pitfalls Research Subagent
|
||||||
|
|
||||||
|
Use this template for spawning pitfalls research subagents:
|
||||||
|
|
||||||
|
```
|
||||||
|
<subagent_prompt>
|
||||||
|
## Objective
|
||||||
|
Research common mistakes and pitfalls in {domain} projects and write findings to .planning/research/pitfalls.md
|
||||||
|
|
||||||
|
## Domain Context
|
||||||
|
{Paste relevant sections from PROJECT.md describing what's being built}
|
||||||
|
|
||||||
|
## Your Assignment
|
||||||
|
File: .planning/research/pitfalls.md
|
||||||
|
Category: pitfalls
|
||||||
|
Purpose: Catalog what NOT to do and why
|
||||||
|
|
||||||
|
## Research Questions
|
||||||
|
Answer these questions through web research:
|
||||||
|
1. What mistakes do beginners commonly make in this domain?
|
||||||
|
2. What causes performance problems?
|
||||||
|
3. What architectural choices lead to regret?
|
||||||
|
4. What seems like a good idea but isn't?
|
||||||
|
5. What are the debugging nightmares people warn about?
|
||||||
|
|
||||||
|
## Research Requirements
|
||||||
|
|
||||||
|
You MUST use WebSearch and Context7 to get current information.
|
||||||
|
|
||||||
|
For EACH pitfall discovered:
|
||||||
|
1. Find real examples (Stack Overflow, GitHub issues, blog posts)
|
||||||
|
2. Understand the root cause
|
||||||
|
3. Find the correct approach
|
||||||
|
4. Note detection methods (how to know if you're doing this)
|
||||||
|
|
||||||
|
**Search queries to run:**
|
||||||
|
- "{domain} common mistakes"
|
||||||
|
- "{domain} things I wish I knew"
|
||||||
|
- "{domain} performance problems"
|
||||||
|
- "{domain} debugging nightmare"
|
||||||
|
- "{specific technology} gotchas"
|
||||||
|
- "{domain} anti-patterns"
|
||||||
|
|
||||||
|
## Output Format
|
||||||
|
|
||||||
|
Write to .planning/research/pitfalls.md using this structure:
|
||||||
|
|
||||||
|
# Pitfalls: {Domain}
|
||||||
|
|
||||||
|
**Category:** pitfalls
|
||||||
|
**Domain:** {domain}
|
||||||
|
**Researched:** {today's date}
|
||||||
|
**Confidence:** {high | medium | low}
|
||||||
|
|
||||||
|
## Research Summary
|
||||||
|
|
||||||
|
{2-3 sentences on the most critical pitfalls to avoid}
|
||||||
|
|
||||||
|
## Findings
|
||||||
|
|
||||||
|
### {Pitfall 1: Descriptive Name}
|
||||||
|
|
||||||
|
**Problem:** {What people do wrong}
|
||||||
|
**Why it happens:** {Root cause or common misconception}
|
||||||
|
**Consequence:** {What goes wrong}
|
||||||
|
**Detection:** {How to know if you're doing this}
|
||||||
|
**Prevention:** {Correct approach}
|
||||||
|
|
||||||
|
**Source:** {URL with real example}
|
||||||
|
**Severity:** {high | medium | low}
|
||||||
|
|
||||||
|
### {Pitfall 2: Descriptive Name}
|
||||||
|
|
||||||
|
{Same structure}
|
||||||
|
|
||||||
|
{... continue for each significant pitfall ...}
|
||||||
|
|
||||||
|
## Recommendations
|
||||||
|
|
||||||
|
### Critical Pitfalls (Must Avoid)
|
||||||
|
|
||||||
|
1. **{Pitfall A}** - {One-line why it's critical}
|
||||||
|
2. **{Pitfall B}** - {One-line why it's critical}
|
||||||
|
|
||||||
|
### Common But Recoverable
|
||||||
|
|
||||||
|
- **{Pitfall C}** - {Can be fixed if caught early}
|
||||||
|
|
||||||
|
### Easy Wins
|
||||||
|
|
||||||
|
- **{Prevention D}** - {Simple thing that prevents problems}
|
||||||
|
|
||||||
|
## Sources
|
||||||
|
|
||||||
|
| Source | Type | Confidence | Last Verified |
|
||||||
|
|--------|------|------------|---------------|
|
||||||
|
| {URL} | {stack overflow / github issue / blog} | {high/medium/low} | {today} |
|
||||||
|
|
||||||
|
## Open Questions
|
||||||
|
|
||||||
|
- {Potential pitfall that needs more context}
|
||||||
|
- {Question about project-specific risks}
|
||||||
|
|
||||||
|
---
|
||||||
|
*Generated by research-project subagent*
|
||||||
|
*Category: pitfalls*
|
||||||
|
|
||||||
|
## Quality Criteria
|
||||||
|
- Include at least 5-7 pitfalls
|
||||||
|
- Categorize by severity
|
||||||
|
- Every pitfall has prevention/solution
|
||||||
|
- Include real examples with sources
|
||||||
|
- Focus on domain-specific issues (not generic coding advice)
|
||||||
|
</subagent_prompt>
|
||||||
|
```
|
||||||
|
</pitfalls_subagent_prompt>
|
||||||
|
|
||||||
|
<standards_subagent_prompt>
|
||||||
|
## Standards Research Subagent
|
||||||
|
|
||||||
|
Use this template for spawning standards research subagents:
|
||||||
|
|
||||||
|
```
|
||||||
|
<subagent_prompt>
|
||||||
|
## Objective
|
||||||
|
Research best practices and quality standards for {domain} projects and write findings to .planning/research/standards.md
|
||||||
|
|
||||||
|
## Domain Context
|
||||||
|
{Paste relevant sections from PROJECT.md describing what's being built}
|
||||||
|
|
||||||
|
## Your Assignment
|
||||||
|
File: .planning/research/standards.md
|
||||||
|
Category: standards
|
||||||
|
Purpose: Document best practices, conventions, and quality expectations
|
||||||
|
|
||||||
|
## Research Questions
|
||||||
|
Answer these questions through web research:
|
||||||
|
1. What does "production quality" mean for this domain?
|
||||||
|
2. What testing approaches work for this type of project?
|
||||||
|
3. What performance benchmarks matter?
|
||||||
|
4. What accessibility/security considerations apply?
|
||||||
|
5. What conventions do experts follow?
|
||||||
|
|
||||||
|
## Research Requirements
|
||||||
|
|
||||||
|
You MUST use WebSearch and Context7 to get current information.
|
||||||
|
|
||||||
|
For EACH standard discovered:
|
||||||
|
1. Find authoritative sources (official docs, style guides)
|
||||||
|
2. Understand the rationale
|
||||||
|
3. Find measurable criteria where possible
|
||||||
|
4. Note enforcement tools if available
|
||||||
|
|
||||||
|
**Search queries to run:**
|
||||||
|
- "{domain} best practices 2024 2025"
|
||||||
|
- "{domain} style guide"
|
||||||
|
- "{domain} testing strategy"
|
||||||
|
- "{domain} performance benchmarks"
|
||||||
|
- "{domain} production checklist"
|
||||||
|
- "{domain} code quality standards"
|
||||||
|
|
||||||
|
## Output Format
|
||||||
|
|
||||||
|
Write to .planning/research/standards.md using this structure:
|
||||||
|
|
||||||
|
# Standards: {Domain}
|
||||||
|
|
||||||
|
**Category:** standards
|
||||||
|
**Domain:** {domain}
|
||||||
|
**Researched:** {today's date}
|
||||||
|
**Confidence:** {high | medium | low}
|
||||||
|
|
||||||
|
## Research Summary
|
||||||
|
|
||||||
|
{2-3 sentences on key quality standards for this project}
|
||||||
|
|
||||||
|
## Findings
|
||||||
|
|
||||||
|
### Code Quality
|
||||||
|
|
||||||
|
**Conventions:**
|
||||||
|
- {Naming conventions}
|
||||||
|
- {Formatting standards}
|
||||||
|
- {Organization patterns}
|
||||||
|
|
||||||
|
**Tools:** {Linters, formatters, static analysis}
|
||||||
|
**Source:** {URL}
|
||||||
|
|
||||||
|
### Testing Standards
|
||||||
|
|
||||||
|
**Strategy:** {How to test this type of project}
|
||||||
|
**Coverage expectations:** {What to test, what's overkill}
|
||||||
|
**Tools:** {Testing frameworks and utilities}
|
||||||
|
|
||||||
|
**Source:** {URL}
|
||||||
|
|
||||||
|
### Performance Standards
|
||||||
|
|
||||||
|
**Benchmarks:** {What metrics matter}
|
||||||
|
**Targets:** {Specific numbers if applicable}
|
||||||
|
**Measurement:** {How to test}
|
||||||
|
|
||||||
|
**Source:** {URL}
|
||||||
|
|
||||||
|
### {Domain-Specific Standard}
|
||||||
|
|
||||||
|
{Standards specific to this domain}
|
||||||
|
|
||||||
|
## Recommendations
|
||||||
|
|
||||||
|
### Adopt
|
||||||
|
|
||||||
|
- **{Standard A}** - {Why it applies}
|
||||||
|
- **{Convention B}** - {Why it matters}
|
||||||
|
|
||||||
|
### Skip (Over-Engineering)
|
||||||
|
|
||||||
|
- **{Standard X}** - {Why not needed for this project}
|
||||||
|
|
||||||
|
### Defer
|
||||||
|
|
||||||
|
- **{Standard Y}** - {Consider after MVP}
|
||||||
|
|
||||||
|
## Sources
|
||||||
|
|
||||||
|
| Source | Type | Confidence | Last Verified |
|
||||||
|
|--------|------|------------|---------------|
|
||||||
|
| {URL} | {official docs / style guide / blog} | {high/medium/low} | {today} |
|
||||||
|
|
||||||
|
## Open Questions
|
||||||
|
|
||||||
|
- {Standard that depends on project scale}
|
||||||
|
- {Question about appropriate rigor level}
|
||||||
|
|
||||||
|
---
|
||||||
|
*Generated by research-project subagent*
|
||||||
|
*Category: standards*
|
||||||
|
|
||||||
|
## Quality Criteria
|
||||||
|
- Cover code quality, testing, and performance
|
||||||
|
- Include measurable criteria where possible
|
||||||
|
- Distinguish must-haves from nice-to-haves
|
||||||
|
- Reference authoritative sources
|
||||||
|
- Be realistic about project scope (not enterprise overkill)
|
||||||
|
</subagent_prompt>
|
||||||
|
```
|
||||||
|
</standards_subagent_prompt>
|
||||||
|
|
||||||
|
<task_tool_usage>
|
||||||
|
## Using the Task Tool
|
||||||
|
|
||||||
|
When spawning research subagents, use the Task tool with:
|
||||||
|
- `subagent_type`: "general-purpose"
|
||||||
|
- `prompt`: The filled-in template above
|
||||||
|
- `description`: Brief description like "Research ecosystem for {domain}"
|
||||||
|
|
||||||
|
**Batching strategy:**
|
||||||
|
|
||||||
|
Spawn 3-4 Task calls in a SINGLE message. Wait for all to complete before next batch.
|
||||||
|
|
||||||
|
```
|
||||||
|
[Message 1: Batch 1]
|
||||||
|
Task: Research ecosystem for {domain}
|
||||||
|
Task: Research architecture for {domain}
|
||||||
|
[Wait for completion]
|
||||||
|
|
||||||
|
[Message 2: Batch 2]
|
||||||
|
Task: Research pitfalls for {domain}
|
||||||
|
Task: Research standards for {domain}
|
||||||
|
[Wait for completion]
|
||||||
|
```
|
||||||
|
|
||||||
|
**Batch ordering rationale:**
|
||||||
|
- Batch 1 (ecosystem + architecture): Core understanding of what to build and how
|
||||||
|
- Batch 2 (pitfalls + standards): Refinements that build on core understanding
|
||||||
|
|
||||||
|
**After all batches complete:**
|
||||||
|
1. Verify all 4 files exist in .planning/research/
|
||||||
|
2. Extract key findings for summary
|
||||||
|
3. Present next steps to user
|
||||||
|
</task_tool_usage>
|
||||||
|
|
||||||
|
<quality_checklist>
|
||||||
|
## Subagent Quality Verification
|
||||||
|
|
||||||
|
After subagents complete, verify:
|
||||||
|
|
||||||
|
- [ ] All 4 files exist in .planning/research/
|
||||||
|
- [ ] Each file has substantive content (not stub/error)
|
||||||
|
- [ ] Recommendations are specific (not "it depends")
|
||||||
|
- [ ] Sources are cited with confidence levels
|
||||||
|
- [ ] Information is current (2024-2025 sources preferred)
|
||||||
|
- [ ] Open questions are honest about gaps
|
||||||
|
</quality_checklist>
|
||||||
@@ -5,6 +5,12 @@ Subagents write directly to `.planning/research/` to preserve main context.
|
|||||||
Maximum 4 parallel subagents, recommended batch size 3.
|
Maximum 4 parallel subagents, recommended batch size 3.
|
||||||
</purpose>
|
</purpose>
|
||||||
|
|
||||||
|
<required_reading>
|
||||||
|
**Read before executing:**
|
||||||
|
1. `~/.claude/get-shit-done/references/research-subagent-prompts.md` - Prompt templates for each category
|
||||||
|
2. `~/.claude/get-shit-done/templates/project-research.md` - Output format subagents use
|
||||||
|
</required_reading>
|
||||||
|
|
||||||
<process>
|
<process>
|
||||||
|
|
||||||
<step name="setup">
|
<step name="setup">
|
||||||
@@ -34,33 +40,45 @@ Each subagent researches ONE category and writes directly to `.planning/research
|
|||||||
<step name="batch_execution">
|
<step name="batch_execution">
|
||||||
## Batched Subagent Spawning
|
## Batched Subagent Spawning
|
||||||
|
|
||||||
|
Read prompt templates from `~/.claude/get-shit-done/references/research-subagent-prompts.md`
|
||||||
|
|
||||||
**Batch 1: Foundation research** (spawn in parallel)
|
**Batch 1: Foundation research** (spawn in parallel)
|
||||||
|
|
||||||
Spawn using Task tool with `subagent_type="general-purpose"`:
|
Spawn using Task tool with `subagent_type="general-purpose"`:
|
||||||
|
|
||||||
```
|
```
|
||||||
Subagent 1: ecosystem.md
|
Task 1:
|
||||||
Subagent 2: architecture.md
|
description: "Research ecosystem for {domain}"
|
||||||
|
prompt: [ecosystem_subagent_prompt template filled with PROJECT.md context]
|
||||||
|
|
||||||
|
Task 2:
|
||||||
|
description: "Research architecture for {domain}"
|
||||||
|
prompt: [architecture_subagent_prompt template filled with PROJECT.md context]
|
||||||
```
|
```
|
||||||
|
|
||||||
**Wait for Batch 1 completion.**
|
Send BOTH Task calls in a single message. Wait for Batch 1 completion.
|
||||||
|
|
||||||
**Batch 2: Risk & quality research** (spawn in parallel)
|
**Batch 2: Risk & quality research** (spawn in parallel)
|
||||||
|
|
||||||
```
|
```
|
||||||
Subagent 3: pitfalls.md
|
Task 3:
|
||||||
Subagent 4: standards.md
|
description: "Research pitfalls for {domain}"
|
||||||
|
prompt: [pitfalls_subagent_prompt template filled with PROJECT.md context]
|
||||||
|
|
||||||
|
Task 4:
|
||||||
|
description: "Research standards for {domain}"
|
||||||
|
prompt: [standards_subagent_prompt template filled with PROJECT.md context]
|
||||||
```
|
```
|
||||||
|
|
||||||
**Wait for Batch 2 completion.**
|
Send BOTH Task calls in a single message. Wait for Batch 2 completion.
|
||||||
|
|
||||||
**Subagent prompt structure:**
|
**Batch ordering rationale:**
|
||||||
|
- Batch 1 (ecosystem + architecture): Core understanding of what to build and how
|
||||||
|
- Batch 2 (pitfalls + standards): Refinements that build on core understanding
|
||||||
|
|
||||||
Use prompts from `~/.claude/get-shit-done/references/research-subagent-prompts.md`
|
**Each subagent receives:**
|
||||||
|
|
||||||
Each subagent receives:
|
|
||||||
- Domain context from PROJECT.md
|
- Domain context from PROJECT.md
|
||||||
- Category assignment (ecosystem, architecture, etc.)
|
- Category assignment (ecosystem, architecture, pitfalls, standards)
|
||||||
- Output format from templates/project-research.md
|
- Output format from templates/project-research.md
|
||||||
- Instruction to write directly to `.planning/research/{category}.md`
|
- Instruction to write directly to `.planning/research/{category}.md`
|
||||||
</step>
|
</step>
|
||||||
|
|||||||
Reference in New Issue
Block a user