Researcher by boshu2
Deep codebase exploration and analysis. Use for understanding code architecture, finding patterns, and gathering context before making changes.
- Type
- Subagent
- Repository
- boshu2/agentops
- GitHub stars
- 446
- License
- Apache-2.0
- Repo last updated
- Sep 26, 2026
- Source file
- agents/researcher.md
- Model
- haiku
What Researcher by boshu2 is
Researcher by boshu2 is a subagent published in the boshu2/agentops repository on GitHub, which has about 446 stars. The repository describes itself as: “DevOps discipline for AI coding agents: shape the work, track it as a graph, and get each change judged by a context that didn't write it.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Researcher and get back a compact result.
It is set up to use these tools: Read, Grep, Glob, Bash. Limiting tools is a good sign: the subagent can only do what those tools allow.
How to install Researcher by boshu2
Claude Code
- Download researcher.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from agents/researcher.md, shared under the repository's Apache-2.0 license. Read the full file on GitHub.
You are a codebase researcher. When invoked:
- Explore the target area thoroughly using Glob and Grep
- Read relevant files to understand architecture and patterns
- Return structured findings with file:line references
Always provide:
- File inventory with key symbols (functions, types, constants)
- Architecture overview (how components connect)
- Key patterns and conventions observed
- Potential concerns or technical debt
Never modify files. Your role is purely investigative.
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Researcher by boshu2?
Researcher by boshu2 is a subagent for Claude Code and Claude Cowork from the boshu2/agentops repository on GitHub. Deep codebase exploration and analysis. Use for understanding code architecture, finding patterns, and gathering context before making changes.
How do I install Researcher by boshu2 in Claude Code?
Download researcher.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Researcher by boshu2 in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Researcher by boshu2 safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Agentops Core Gemini AgentOps 65-skill image (61 CORE + 4 AGY operator) packaged for Google Antigravity (AGY) / Gemini. Portable SKILL.md set (identical to the… Plugin · boshu2/agentops
- Agentops Antigravity Core AgentOps core operator skills packaged for Google Antigravity with Agent Mail MCP and AgentOps guard hooks. Plugin · boshu2/agentops
- Code Reviewer Expert code review specialist. Use proactively after writing or modifying code to check quality, security, and maintainability. Subagent · boshu2/agentops
- Agentops Engineering guidance for coding agents: behavior-driven planning, shared domain language, independent validation, and reusable improvements. Plugin · boshu2/agentops
- Robot Architect Java architecture specialist. Explores design alternatives, records significant decisions as ADRs, and creates architecture diagrams… Subagent · jabrena/plinth
- Robot Business Analyst Business analyst. Creates structured GitHub or Jira issues and performs read-only alignment and readiness reviews across requirements… Subagent · jabrena/plinth
- Xref Analyzer Analyze module dependencies and context boundaries using mix xref. Use proactively before major refactors or when reviewing architectural changes. Subagent · oliver-kriska/claude-elixir-phoenix
- Robot Java Coder Implementation specialist for Java projects. Use when writing code, refactoring, configuring Maven, or applying Java best practices. Subagent · jabrena/plinth