Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/researcher.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

researcher thoreinstein researcher — a subagent that digs through an Obsidian vault: chains semantic search, full note reads and wikilink hops, then answers with note citations. CX Codex +1 ★ 102repo stars wiki-researcher microsoft The wiki-researcher subagent maps a codebase and traces data flows, integrations, and design choices with file-and-line evidence. Use it when you need a grounded account of how a project fits together. CX Codex +1 ★ 3,232repo stars code-explorer waybarrios code-explorer — a skill to analyze codebases: traces execution paths, maps architectural layers, uncovers patterns and dependencies. Use it before modifying or extending a feature. CX Codex +1 146installs technical-researcher davila7 technical-researcher — a subagent that digs through repositories and technical docs, then hands back a JSON report with metrics and implementation advice. CX Codex 3,344installs analyze-project lllllllama analyze-project reads a deep learning repository and maps its structure, entrypoints and suspicious spots. Changes nothing, runs no heavy jobs. CX Codex +1 363,500installs docs-researcher VoltAgent docs-researcher — a subagent that verifies APIs, version-specific behavior and framework options against official documentation. CX Codex ★ 6,505repo stars gsd-phase-researcher davepoon gsd-phase-researcher researches a phase before planning and writes findings to RESEARCH.md for gsd-planner. Start it through /gsd:plan-phase or /gsd:research-phase. CX Codex ★ 3,785repo stars

From the same set76

The whole set →
api-docs api-docs — a Claude Code subagent that inspects application endpoints to produce and maintain OpenAPI 3.0 specifications. CX Codex ★ 850repo stars examples The examples command presents pair-programming sessions for JWT auth, Node.js debugging, TDD, refactoring, React performance, and Express APIs. CX Codex +1 ★ 850repo stars base-template-generator base-template-generator writes the starting file set for a new component, endpoint or project config, then reuses templates that worked before. CX Codex ★ 850repo stars planner planner is a Claude Code subagent that breaks down engineering goals, maps dependencies, and allocates agents using execution memory. CX Codex ★ 850repo stars v3-integration-architect v3-integration-architect — a Claude subagent that carries out ADR-001: folding claude-flow into agentic-flow@alpha as an extension and cutting 10,000+ duplicated lines. CX Codex ★ 850repo stars sync-coordinator sync-coordinator aligns versions, dependencies, and docs across linked repositories. It orchestrates agent swarms using GitHub CLI and MCP tools. CX Codex +1 ★ 850repo stars architecture architecture designs system structure from specifications and pseudocode, covering components, interfaces, technology choices, and deployment. CX Codex ★ 850repo stars repo-architect repo-architect optimizes repository layouts and synchronizes files across projects using agent swarms. Helpful when setting up standard templates and multi-repo workflows. CX Codex +1 ★ 850repo stars

Project sponsors

Companies that keep this analytics open