[DOCS] Sub-agents quickstart still walks through the `/agents` wizard that v2.1.198 removed

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/sub-agents

Section/Topic

• The "Quickstart: create your first subagent" section, which currently uses the removed wizard
• The /agents row on the commands reference, which still describes the command as the manager for subagent configurations without noting that the wizard was removed
• The agents.md page, which describes /agents as opening the subagents manager panel

Current Documentation

The sub-agents quickstart opens by telling users to invoke /agents and step through a generated flow:

Subagents are defined in Markdown files with YAML frontmatter. You can [create them manually](#write-subagent-files) or use the /agents command. This walkthrough guides you through creating a user-level subagent with the /agents command. The subagent reviews code and suggests improvements for the codebase. <Steps> <Step title="Open the subagents interface"> In Claude Code, run: ``text wrap theme={null} /agents ` </Step> <Step title="Choose a location"> Switch to the **Library** tab, select **Create new agent**, then choose **Personal**. This saves the subagent to ~/.claude/agents/ so it's available in all your projects. </Step> <Step title="Generate with Claude"> Select **Generate with Claude**. When prompted, describe the subagent: `text wrap theme={null} A code improvement agent that scans files and suggests improvements for readability, performance, and best practices. It should explain each issue, show the current code, and provide an improved version. `` Claude generates the identifier, description, and system prompt for you.

The commands reference still has:

| /agents | Manage agent configurations |

And agents.md:

For subagents in the current session, /agents opens a panel with a Running tab listing live subagents and a Library tab where you create and edit custom subagents.

What's Wrong or Missing?

The release notes for v2.1.198 explicitly remove the wizard:

Removed the /agents wizard; ask Claude to create or manage subagents, or edit .claude/agents/ directly

Three things are out of date as a result:

• The quickstart still tells authors to invoke /agents and step through the generated wizard flow.
• The /agents row in the commands reference still describes the command as "Manage agent configurations" with no indication that the interactive creation flow was removed.
• agents.md still describes /agents as opening a Library tab where you create and edit subagents, which is the wizard flow that no longer exists.

Suggested Improvement

A. Sub-agents quickstart

Replace the "open the subagents interface" → "choose a location" → "Generate with Claude" wizard steps with the new approach. The new walkthrough should describe editing .claude/agents/ directly or asking Claude to create a subagent:

Subagents are defined in Markdown files with YAML frontmatter under .claude/agents/. Ask Claude to create or manage a subagent, or [write the file yourself](#write-subagent-files). This walkthrough creates a user-level subagent that reviews code and suggests improvements for the codebase. <Steps> <Step title="Decide on the location"> Personal subagents live in ~/.claude/agents/. Project-scoped subagents live in .claude/agents/ inside the repository. The example below uses the personal location. </Step> <Step title="Write the subagent file"> Create ~/.claude/agents/code-improver.md: ``markdown --- name: code-improver description: A code improvement agent that scans files and suggests improvements for readability, performance, and best practices. Use proactively after edits. --- Review the current diff or the file Claude is about to edit. Explain each issue, show the current code, and provide an improved version. ` </Step> <Step title="Try it out"> Ask Claude to use the subagent by name: `text wrap theme={null} Use the code-improver agent to suggest improvements in this project `` </Step> </Steps>

B. /agents command row

| /agents | Switch to or open the subagents manager panel. As of v2.1.198, the wizard that previously walked through creating a new subagent has been removed; create or edit subagents by asking Claude, or edit .claude/agents/ directly. See Sub-agents for the file format. |

C. agents.md cross-reference

For subagents in the current session, /agents opens a manager panel listing running subagents. As of v2.1.198 the wizard that created and edited custom subagents from inside the panel is gone; create or edit subagents by asking Claude, or edit .claude/agents/ directly.

Impact

High - Prevents users from using a feature

Additional Context

Related v2.1.198 change:

Removed the /agents wizard; ask Claude to create or manage subagents, or edit .claude/agents/ directly

The change is destructive: a user who follows the existing quickstart will invoke /agents, see no wizard, and have no way to recover the workflow from the documentation alone. No open docs issue in the prefetched queue currently flags the removed wizard.

Affected Pages:

| Page | Context |
|---|---|
| https://code.claude.com/docs/en/sub-agents | Quickstart walkthrough uses the removed /agents wizard |
| https://code.claude.com/docs/en/commands | /agents row describes the command but omits the removal |
| https://code.claude.com/docs/en/agents | Cross-reference still describes /agents as opening a Library tab for create and edit |