research-orchestrator — Claude Code subagent: how to install
Coordinates multi-phase deep research projects in Claude Code. The subagent plans the workflow and assigns tasks to specialized investigation agents.
npx claude-code-templates@latest --agent deep-research-team/research-orchestratorWhat research-orchestrator does
The subagent oversees the entire research pipeline based on the Open Deep Research framework. It begins by examining the initial query for clarity and scope. If the request is broad, it routes the prompt to clarify goals before generating a structured research plan.
Parallel investigations are split across specialized sub-agents such as technical or academic researchers. To maintain visibility, the orchestrator tracks every step in a TodoWrite task list and structures inter-agent messages as JSON records containing coverage metrics.
The orchestrator manages the team. Without companion subagents like research-synthesizer or report-generator installed in the project, the workflow halts when calling the next specialist.
What it helps with
- break broad research questions into ordered phases
- delegate tasks to academic and web researchers
- track investigation milestones through structured checklists
- merge disparate agent findings into a coherent report
Example prompts for the agent
- Coordinate a structured research process on AI safety and compile the report
- Run a research project on how quantum computing impacts modern cryptography
How to install research-orchestrator
1claude-code-templates
npx claude-code-templates@latest --agent deep-research-team/research-orchestrator2Manually: put the files in place
.claude/agents/research-orchestrator.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/research-orchestrator.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/research-orchestrator.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about research-orchestrator
How to install research-orchestrator in Claude Code?
Run npx claude-code-templates@latest --agent deep-research-team/research-orchestrator in your terminal. This creates the configuration file at .claude/agents/research-orchestrator.md.
What does research-orchestrator do?
It manages the entire lifecycle of an investigation query. The subagent clarifies objectives, outlines research briefs, and orchestrates specialized agents through synthesis and reporting.
Which tools does research-orchestrator require?
The agent definition requests Read, Write, Edit, Task, and TodoWrite. These tools allow it to inspect files, assign subtasks, and track project milestones.