researcher · ruvnet — Claude Code subagent: what it does, how to install
The researcher subagent examines code, documentation, and module relationships, then organizes findings into a research summary. Use it to map an unfamiliar project or spot gaps in its docs.
no license ★ 850 updated 2026-10-26
.claude/agents/researcher.mdWhat researcher does
researcher inspects code and documentation, identifies recurring approaches and anti-patterns, and traces links between internal modules and external packages. Its findings are organized into a summary covering project structure, dependencies, recommendations, and gaps.
The instructions describe file searches, cross-checking definitions against their usages, and reviewing Git history. Before and after a task, hooks use npx claude-flow to look up related research and save results. Those hook steps depend on claude-flow and its memory features being available; otherwise, they cannot run as described.
For Claude Code, install the subagent at .claude/agents/researcher.md. It is set up to investigate and report on a codebase, not to make code changes automatically.
What it helps with
- map the structure of a codebase
- spot recurring patterns and anti-patterns
- trace dependencies between modules
- compare project documentation with implementation
- compile findings and gaps into recommendations
Example prompts for the agent
- Research this project's structure and describe its main architectural patterns.
- Trace dependencies between the modules and show where they are used.
- Compare the documentation with the code and list the gaps you find.
How to install researcher
Manually: put the files in place
.claude/agents/researcher.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/researcher.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/researcher.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 researcher
How do I install researcher in Claude Code?
Add the subagent file at .claude/agents/researcher.md.
What does researcher do?
It examines code and documentation, tracks patterns and dependencies, and compiles findings into a summary with recommendations.
Why does researcher use claude-flow?
Its hooks use npx claude-flow to search for related past research and store results in memory. Those steps rely on claude-flow and its memory features.
Similar subagents
All subagents for Agent setup: memory, context, orchestration →researcher by other authors comes first.