Research task workflow — @researcher agent for technology evaluation, best practices lookup, documentation discovery, with timeout limits and memory guidelines
"Research: [topic]"
@researcher → report with sources
| Scenario | Use @researcher? |
|---|---|
| New library/framework needed | YES |
| Best practices for unfamiliar domain | YES |
| Security advisory check | YES |
| API documentation lookup | YES |
| Well-known patterns (REST, MVC) |
| NO |
| Bug fix in existing code | NO |
| Refactoring known code | NO |
| Phase | Timeout | Action on Timeout |
|---|---|---|
| WebSearch | 10s | Use cached/partial results |
| WebFetch | 8s | Skip this source |
| Analysis | 12s | Report with available data |
| Total | 30s | Produce partial report |
# Research Report: [Topic]
## Summary
[1-2 sentence overview of findings]
## Findings
1. [Finding with source]
2. [Finding with source]
3. [Finding with source]
## Recommendation
[Clear recommendation with rationale]
## Sources
- [Source 1](URL) — [brief description]
- [Source 2](URL) — [brief description]
## Confidence
[HIGH/MEDIUM/LOW] — [reason]
Save to: reports/vX.X.X/00-researcher-report.md
If research fails or times out:
Partial report format includes completion_percentage and sources_status (FULL/PARTIAL/PENDING).
After completing research:
@researcher is OPTIONAL in Feature and API Change workflows:
Feature: (@researcher) → @architect → @builder → gates → @scribe
API Change: (@researcher) → @architect → @api-guardian → @builder → gates → @scribe
Use when the task involves unfamiliar technology. Skip when working with known patterns.37:["$","$L3f",null,{"content":"$40","frontMatter":{"name":"research","description":"Research task workflow — @researcher agent for technology evaluation, best practices lookup, documentation discovery, with timeout limits and memory guidelines"}}]