# technical-researcher

A subagent that digs through repositories and technical docs, then hands back a JSON report with metrics and implementation advice.

- subagent · `type=agent` · Claude Code · 3344 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/deep-research-team/technical-researcher.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/technical-researcher

## What it does

\`technical-researcher` is a Claude subagent built for reading code and documentation. It scans GitHub and GitLab projects, reviews API specs, hunts down implementation examples, and compares libraries against each other. Reach for it when you are picking a framework or want to know how someone else's project is put together before you depend on it.

The agent carries its own evaluation checklist: architecture, maintainability, performance, security, test coverage, community activity, maintenance status. Output is JSON — a search summary, repository cards with stats, and recommendations tied to a scenario. Its toolset is `Read`, `Write`, `Edit`, `WebSearch`, `WebFetch`, `Bash`.

One thing to plan for: `WebSearch` and `WebFetch` go out to the network, so on an air-gapped machine the agent has nothing to pull repository data from. Install with `npx claude-code-templates@latest --agent deep-research-team/technical-researcher`; the agent file lands at `.claude/agents/technical-researcher.md`.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent deep-research-team/technical-researcher
```

2. **Manually: put the files in place**
- File: `.claude/agents/technical-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/technical-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/technical-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/deep-research-team/technical-researcher.md

## When to use it
- compare two libraries by activity and code quality
- find real-world examples of an algorithm in open source
- decide whether a third-party repo is safe to depend on
- read through API docs before wiring up an integration
- track breaking changes across versions

## Example prompts
- Analyze the FastAPI repository: architecture, tests, maintenance activity
- Compare rate limiting implementations in open source libraries and recommend one
- Find usage examples for this API and return a JSON report

## Similar
- [Technical Debt Remediation Plan](https://affpapa.org/en/nevibecode/agents/technical-debt-remediation-plan.md) — subagent · ★ 40418
- [frontend-developer](https://affpapa.org/en/nevibecode/agents/voltagent-community-frontend-developer.md) — subagent · 40905 installs
- [dx-optimizer](https://affpapa.org/en/nevibecode/agents/dx-optimizer.md) — subagent · 1198 installs
- [mlops-engineer](https://affpapa.org/en/nevibecode/agents/voltagent-community-mlops-engineer.md) — subagent · 1009 installs
- [postgres-pro](https://affpapa.org/en/nevibecode/agents/postgres-pro.md) — subagent · 897 installs
- [agent-installer](https://affpapa.org/en/nevibecode/agents/agent-installer.md) — subagent · 363 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 205 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