[DOCS] Documentation missing for new 'Explore' subagent
Documentation Type
Missing documentation (feature not documented)
Documentation Location
The documentation for subagents is missing this new built-in feature. The most relevant page is: https://docs.claude.com/en/docs/claude-code/sub-agents
Section/Topic
The page should be updated to include a section on Built-in Subagents, or the new "Explore" subagent should be added to the "Example subagents" section.
Current Documentation
The current documentation primarily focuses on how to create, configure, and manage custom subagents. The "Example subagents" section lists "Code reviewer," "Debugger," and "Data scientist" as examples that users can create, but there is no mention of a pre-existing, built-in "Explore" subagent.
What's Wrong or Missing?
A recent update (potentially v2.0.17) introduced a new built-in subagent called "Explore". According to the release note snippet, it is "Powered by Haiku" and designed to "search through your codebase efficiently to save context!".
This feature is completely absent from the official documentation. Users will not know it exists, what its purpose is, how to use it, or what tools it has access to without discovering it by chance and querying the agent itself.
Suggested Improvement
A new section should be added to the subagents documentation detailing the built-in "Explore" subagent. This documentation should cover:
- Its purpose (fast codebase exploration).
- Its benefits (powered by Haiku for speed and efficiency, saves context).
- When to use it (understanding project structure, finding functionality, gathering context).
- The tools it has access to (Glob, Grep, Read, and Bash).
The response I received from Claude Code itself when I asked about the agent provides an excellent starting point for the documentation content.
Impact
High - Prevents users from using a feature
Additional Context
The release note for the new version mentioned the feature:
the latest update v2.0.17 introduced the following "Introducing the Explore subagent. Powered by Haiku it'll search through your codebase efficiently to save context!"
Here is the transcript from my Claude Code session where I discovered and learned about the agent:
> what does @agent-Explore do
⏺ The Explore agent is a fast, specialized agent designed for exploring and understanding codebases. Here's
what it does:
Purpose
It helps you quickly navigate and understand code without having to manually run multiple search commands
yourself.
Key Capabilities
- Find files by patterns - e.g., locate all TypeScript components with src/components/**/*.tsx
- Search code for keywords - e.g., find all API endpoints, function definitions, or specific patterns
- Answer codebase questions - e.g., "How does authentication work?" or "Where are errors handled?"
When to Use It
The Explore agent is ideal for:
- Understanding project structure
- Finding where specific functionality is implemented
- Discovering conventions and patterns in the codebase
- Gathering context before making changes
- Open-ended exploration that might require multiple rounds of searching
Tools It Uses
The agent has access to: Glob, Grep, Read, and Bash
Why It's Useful
Instead of you manually running multiple Grep and Glob commands in sequence, the Explore agent can
autonomously perform multi-step exploration and synthesize findings for you - making it faster and more
efficient for understanding unfamiliar codebases.This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗