[DOCS] Resume docs missing `--agent` reuse behavior and precedence details (v2.1.32)

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/cli-reference

Section/Topic

Interaction between --resume and --agent, including default reuse behavior and override precedence.

Current Documentation

CLI flag docs currently describe the flags independently:

--agent: "Specify an agent for the current session (overrides the agent setting)"

--resume: "Resume a specific session by ID or name, or show an interactive picker to choose a session"

No section documents what happens to agent selection when resuming.

What's Wrong or Missing?

Claude Code changelog v2.1.32 says:

Updated --resume to re-use --agent value specified in previous conversation by default.

This behavior is not documented in CLI reference or resume workflow docs, so users do not know:

1. That --resume now inherits prior --agent by default.
2. How explicit --agent flags override resumed defaults.
3. Whether /resume behaves the same way as CLI --resume.
4. How this interacts with project/user agent settings.

Suggested Improvement

Add an explicit resume + agent selection section in CLI docs with a precedence table:

1. --resume alone: inherits prior session's agent.
2. --resume + explicit --agent: explicit flag wins.
3. /resume behavior in interactive mode.
4. Fallback behavior when previous agent no longer exists.

Include examples for each case.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/cli-reference | 30, 65 | --agent and --resume described independently with no interaction details |
| https://code.claude.com/docs/en/common-workflows | 555-557, 631 | Resume workflow documented, but no explicit --agent reuse/override behavior |

Total scope: 2 pages affected

Source: Claude Code changelog v2.1.32

Updated --resume to re-use --agent value specified in previous conversation by default.