# comprehensive-researcher

A Claude subagent that turns a topic into research questions, gathers sources and writes a cited report. Useful when you need an overview, not a guess.

- subagent · `type=agent` · Claude Code · 735 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/podcast-creator-team/comprehensive-researcher.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/comprehensive-researcher

## What it does

The subagent runs in steps. It breaks a topic into 5–8 specific research questions, then looks for at least 3–5 sources per question: academic papers, government and institutional reports, established news outlets, expert commentary. Each source gets checked for credibility and recency, and the agent notes where authors agree and where they clash.

What comes back is a structured report: an executive summary of key findings, an introduction setting the scope, a main body organised by question or theme, inline citations next to claims, and a full bibliography. Cross-checking is its own step — facts get verified across sources, controversial points are shown from several sides, and when reliable material is thin the agent says so instead of filling the gap.

Under the hood it is a single agent file describing the process, with four tools declared: `Read`, `Write`, `Edit`, `WebSearch`. So web search access is what makes the sourcing step work, and file write access is what lets it save the report. Run it somewhere without web search and that stage simply does not happen.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent podcast-creator-team/comprehensive-researcher
```

2. **Manually: put the files in place**
- File: `.claude/agents/comprehensive-researcher.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/comprehensive-researcher.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/comprehensive-researcher.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/podcast-creator-team/comprehensive-researcher.md

## When to use it
- break an unfamiliar topic into answerable questions
- produce a report with citations
- verify facts across sources and surface disagreements
- separate confirmed findings from opinion
- get several viewpoints on a contested topic

## Example prompts
- research CI/CD options for small teams and write a cited report
- break down vector databases into questions, sources and conclusions
- survey API caching approaches and flag where experts disagree

## Similar
- [dossier](https://affpapa.org/en/nevibecode/skills/dossier.md) — skill · 319 installs
- [firecrawl-deep-research](https://affpapa.org/en/nevibecode/skills/firecrawl-deep-research.md) — skill · 35400 installs
- [tavily-research](https://affpapa.org/en/nevibecode/skills/tavily-research.md) — skill · 22000 installs
- [deep-research](https://affpapa.org/en/nevibecode/skills/199-biotechnologies-deep-research.md) — skill · 10200 installs
- [paper-spine](https://affpapa.org/en/nevibecode/skills/paper-spine.md) — skill · 1200 installs
- [research-with-sources](https://affpapa.org/en/nevibecode/skills/research-with-sources.md) — skill · 826 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 224 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md