[DOCS] Documentation missing for new 'Explore' subagent

Resolved 💬 1 comment Opened Oct 15, 2025 by coygeek Closed Dec 3, 2025

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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗