10x-research — Claude Code command: analyze codebase with sub-agents
10x-research spawns parallel sub-agents to investigate your codebase comprehensively. Finds architectural patterns, component connections, and generates a markdown research report with code references.
AGPL-3.0 ★ 267 updated 2026-02-20
.claude/commands/10x-research.mdWhat 10x-research does
The command breaks your research question into subtasks and runs multiple agents simultaneously across different parts of the codebase. Each agent specializes in a specific job—locating files, analyzing dependencies, tracing data flows. Results are synthesized into a single report with file paths, line numbers, and GitHub permalinks.
You start by describing what to investigate. If you mention specific files, they're read in full before sub-agents spawn. The command then builds a research plan, waits for all agents to complete, and compiles findings with exact code references. The report saves to thoughts/shared/research/ with a timestamp and optional ticket number in the filename.
Follow-up questions can be added to the same document—the command updates the metadata and appends a new investigation section, spawning fresh sub-agents as needed.
What it helps with
- explore an unfamiliar codebase architecture in a single query
- locate all files connected to a specific feature or component
- identify design patterns and architectural principles across the project
- trace how data flows and dependencies connect different modules
- preserve research findings with full code references for team sharing
Example prompts for the agent
- How is authentication structured in our app and where are permissions checked?
- Find all React components using Redux and show how they connect.
- Trace the data flow from API endpoints to the database in the payments module.
How to install 10x-research
Manually: put the files in place
.claude/commands/10x-research.mdCall it with /10x-research. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/10x-research.mdCall it with /prompts:10x-research. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/10x-research.prompt.mdManually: put the files in place
.gemini/commands/10x-research.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about 10x-research
How do I install 10x-research in Claude Code?
Copy 10x-research.md into the .claude/commands/ directory of your project. The command becomes available immediately in Claude Code.
What does 10x-research do?
Launches multiple agents in parallel to analyze your codebase, identifies files and architectural patterns, maps component connections, and produces a report with code references.
Where does the research report get saved?
Reports are written to thoughts/shared/research/ with filenames like YYYY-MM-DD-ENG-XXXX-description.md. Without a ticket number, the filename starts with the date and topic.