Skip to main content
subagent CX Codex

research-analyst · voltagent/awesome-codex-subagents — Codex subagent: what it does, how to install

research-analyst — a Codex subagent for structured technical research, source checks, and confidence-rated conclusions. Use it when an implementation or design decision needs evidence.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/research-analyst.toml
Open on GitHub

What research-analyst does

research-analyst turns a broad technical question into a scoped investigation. It defines the decision goal, gathers and ranks evidence, separates observed facts from inference, then connects trade-offs to implementation or architecture. Its output includes findings by theme, confidence-rated claims, open questions, and a next evidence-gathering step.

The subagent checks whether major claims have traceable support, looks for contradictions between sources, and avoids forcing a recommendation when the evidence is weak unless the parent agent asks for one. In Codex, the agent file must be placed at .codex/agents/research-analyst.toml without the extra space after the backtick; that path is required for installation.

What it helps with

  • frame a technical investigation around constraints
  • rank sources by relevance and quality
  • separate evidence from inference
  • assess risks in an architecture choice
  • turn incomplete research into a next step

Example prompts for the agent

  • Investigate the storage options for this project and connect the findings to architecture consequences.
  • Compare implementation approaches for this feature, with confidence levels for the main claims.
  • Review the evidence on this technical question and identify unknowns that could reverse the recommendation.

How to install research-analyst

Manually: put the files in place

.codex/agents/research-analyst.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/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about research-analyst

How do I install research-analyst in Codex?

Create the file at .codex/agents/research-analyst.toml without the extra space after the backtick.

What does research-analyst do?

It runs a structured investigation of a technical topic, evaluates supporting evidence, and returns conclusions with confidence levels and practical next steps.

When does research-analyst avoid a recommendation?

It does so when the available evidence is too weak, unless the parent agent explicitly requests a recommendation.

Source text

research-analyst.toml · MIT
# research-analyst

Use when a task needs a structured investigation of a technical topic, implementation approach, or design question.

Own structured research as decision-ready investigation with explicit evidence quality.

Convert broad technical questions into clear conclusions, uncertainty boundaries, and next actions.

Working mode:
1. Define investigation question, context constraints, and decision objective.
2. Gather and prioritize evidence from highest-quality sources.
3. Synthesize findings into claims with confidence levels and caveats.
4. Provide recommendation only when evidence strength is sufficient.

Focus on:
- problem framing and scope discipline for investigation efficiency
- source quality and relevance ranking
- separation of observed facts, inference, and opinion
- tradeoff analysis tied to implementation or architectural consequences
- constraint awareness from repository/product context
- uncertainty articulation and risk of incorrect decision
- actionable next step when evidence is incomplete

Quality checks:
- verify each major claim has traceable supporting evidence
- confirm recommendation strength matches confidence level
- check for unresolved contradictions across sources
- ensure implications are practical for execution, not abstract
- call out key unknowns that could invert the recommendation

Return:
- structured summary of findings by theme
- confidence-rated key claims
- recommendation (or explicit no-recommendation) with rationale
- open questions and high-impact unknowns
- next evidence-gathering step

Do not overstate certainty or force a recommendation when evidence is insufficient unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

research-analyst by other authors comes first.

research-analyst VoltAgent Community research-analyst gathers data across the web and project files, synthesizes findings into structured reports, and extracts actionable insights for strategic decisions. CX Codex 575installs research-craft curiositech research-craft is a Claude Code skill for framing academic problems, validating evidence, and drafting thesis chapters or scholarly papers. CX Codex +1 153installs research_analyst AgenticOrgLab The research_analyst Claude Code subagent turns a research question and supplied sources into a structured report. It compares conflicting claims and marks its own inferences separately. CX Codex ★ 776repo stars hr-network-analyst curiositech hr-network-analyst applies graph theory to map professional networks and identify influence brokers. Pinpoints Gladwellian superconnectors and structural holes across industry communities. CX Codex +1 184installs technical-analyst tradermonty technical-analyst is a Claude Code skill that performs technical analysis on weekly chart images. It calculates support and resistance levels, trend strength, and probability-weighted price scenarios. CX Codex +1 4,500installs competitive-analyst VoltAgent Community The competitive-analyst subagent researches direct and indirect competitors, compares products, and suggests positioning strategies. Use it when you need a structured competitor review before making a strategic decision. CX Codex 812installs trend-analyst VoltAgent Community The trend-analyst subagent scans change signals, finds patterns, and builds future scenarios. Use it when trend analysis needs to inform product or strategic decisions. CX Codex 753installs

From the same set176

The whole set →
ai-governance-auditor ai-governance-auditor assesses AI boundaries, change management, and deployment readiness to spot critical operational risks before launch. CX Codex ★ 6,505repo stars trend-analyst The trend-analyst subagent turns technology and adoption signals into trend assessments for architecture, roadmap, and team planning decisions. CX Codex ★ 6,505repo stars search-specialist search-specialist is a Codex subagent that searches your repository and external sources before analysis. It finds where a function is called, locates a config file, or gathers code examples matching a pattern. CX Codex ★ 6,505repo stars scientific-literature-researcher scientific-literature-researcher gathers published research, checks sample sizes and methodologies, and synthesizes findings weighted by study quality. CX Codex ★ 6,505repo stars project-idea-validator project-idea-validator — a Codex subagent that hunts fatal flaws in a product idea — rivals, demand, moat — and returns a kill, pivot or proceed call before you build. CX Codex ★ 6,505repo stars market-researcher market-researcher runs market and competitor research for technical product decisions. Helps evaluate build-vs-buy trade-offs, switching costs, and positioning. CX Codex ★ 6,505repo stars first-principles-thinking The first-principles-thinking subagent strips a problem down to basic facts, tests its assumptions, and rebuilds the solution. Use it when the current approach may be misleading. CX Codex ★ 6,505repo stars docs-researcher docs-researcher — a subagent that verifies APIs, version-specific behavior and framework options against official documentation. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open