Skip to content

Research Fleet

Dispatch 5–7 subagents simultaneously, each exploring a different research dimension with structured prompts. Combine outputs into a single aggregated deliverable via an executive summary agent.

When to Use

  • Broad exploration across multiple dimensions (market research, architecture options, competitive analysis)
  • Each dimension is independent — no cross-agent coordination needed during research
  • Time-sensitive: 5 agents running in parallel complete in ~5 minutes wall-clock regardless of breadth

Architecture

DiagramDiagram

Key Design Points

  • Each agent writes to a known file path. Use /tmp/research-<dimension>.md naming. The aggregator reads all files after all agents complete.
  • Structured prompts with clear scope. Each agent gets a focused brief: "Research X. Cover these specific aspects. Write findings to /tmp/research-x.md."
  • Use a fast, capable model for research agents. Research is read-heavy with web search and synthesis — a model that's fast and good at summarization is ideal.
  • The aggregator is the quality gate. Individual research agents may produce uneven quality. The aggregator (usually opus) synthesizes, identifies gaps, and produces the final deliverable.
  • Output as a gist for sharing. Multi-file research output is too large for chat. Combine into a single gist with one file per dimension plus an executive summary.

Cost Profile

  • Burst cost: all agents run simultaneously, ~3–4 minutes each
  • Total wall-clock: ~5 minutes regardless of how many dimensions
  • Per-agent cost depends on model choice — cheaper models for data gathering, expensive model only for aggregation

Failure Modes

  • Agent scope creep — without tight prompts, agents overlap and produce redundant content
  • Silent failure — an agent fails or writes nothing; aggregator proceeds without that dimension. Check file existence before aggregation.
  • Web search unavailable — some models or spawn configurations don't have web search. Verify tool availability in the agent config.

Built with OpenClaw 🤖