[DOCS] Undocumented built-in subagents: Bash and statusline-setup`

Resolved 💬 2 comments Opened Jan 10, 2026 by coygeek Closed Jan 10, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

docs/en/sub-agents.md

Section/Topic

"Built-in subagents" section

Current Documentation

The documentation currently lists the following as built-in subagents:

  • Explore: A fast, read-only agent optimized for searching.
  • Plan: A research agent used during plan mode.
  • General-purpose: A capable agent for complex, multi-step tasks.

What's Wrong or Missing?

The Task tool definition in the System Prompt lists additional available agent types that are not currently described in the documentation:

  1. Bash: Described in the system prompt as a "Command execution specialist for running bash commands. Use this for git operations, command execution, and other terminal tasks."
  2. statusline-setup: Described as "Use this agent to configure the user's Claude Code status line setting."

Users relying solely on the documentation are unaware these specialized agents exist or when they should be utilized.

Suggested Improvement

Update docs/en/sub-agents.md to include entries for Bash and statusline-setup in the "Built-in subagents" section.

Suggested text based on system prompt definitions:

Bash

  • Purpose: Command execution specialist.
  • Use case: Running git operations, command execution, and terminal tasks.

statusline-setup

  • Purpose: Configuration specialist.
  • Use case: Configuring the user's Claude Code status line setting.

Impact

High - Prevents users from using a feature

Additional Context

Medium - Makes feature difficult to understand/discover. Users may attempt to use general-purpose for tasks better suited for the specialized Bash agent.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗