Skip to content

AGENT-INSTALL.md: Step 4 verification references the removed /agents command #1

Description

@zxcj04

Problem

install/AGENT-INSTALL.md, Step 4 ("Verify and hand off"), item 4 says:

After restart, /agents should list the six roles and /model should show the new default.

As of Claude Code 2.1.198, the /agents wizard has been removed. Running /agents now prints:

The /agents wizard has been removed.
Ask Claude to create or update subagents for you (e.g. "create a code-reviewer subagent that ..."),
or edit the files directly: .claude/agents/ (project) / ~/.claude/agents/ (all projects)

Changelog entry (v2.1.198): "Removed the /agents wizard; ask Claude to create or manage
subagents, or edit .claude/agents/ directly"
https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

So an agent (or human) following the runbook on a current Claude Code version hits a
dead end at this verification step. The /model half of the sentence still works.

Suggested fix

Replace the /agents reference with a verification that works on current versions, e.g.:

  • rely on Step 4.2 (ls ~/.claude/agents/ shows all six files), and/or
  • after restart, ask Claude "which subagent types are available?" — the six roles
    (scout, Explore, mech-executor, executor, verifier, security-executor) should be listed.

Optionally note that on Claude Code < 2.1.198 the old /agents command still applies.

Environment

  • Claude Code 2.1.205, Linux
  • pilotfish v1.1.0

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions