[DOCS] `/code-review` documentation omits its new background-subagent behavior

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/code-review

Section/Topic

The “Review a diff locally” section, including the relationship between /code-review, background work, and stacked slash commands.

Current Documentation

The section currently says:

The /code-review command reviews a diff in your terminal without installing the GitHub App. Run it in any Claude Code session...

It then describes the review as work that runs in the current session, but does not state that the command now runs as a background subagent.

What's Wrong or Missing?

Claude Code 2.1.218 changed /code-review to run as a background subagent. The current wording makes the command sound like a foreground operation that fills the conversation, so users cannot tell why the review no longer consumes the main conversation or how to monitor it.

The release also preserves stacked slash commands as the review target. The documentation does not explain that a command sequence should be interpreted as the target at the point where /code-review is invoked, which matters when users queue several slash commands in one prompt.

Suggested Improvement

Add a versioned note to “Review a diff locally” explaining that, as of Claude Code v2.1.218, /code-review runs in a background subagent and returns its findings to the current session when complete. Explain how to monitor or stop that background review.

Also document that when slash commands are stacked, /code-review keeps the intended review target from that command sequence rather than losing the target to a later command. Include a short example showing the supported stacked form and clarify whether --fix applies after the background review returns.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/code-review | “Review a diff locally” execution model and target handling |
| https://code.claude.com/docs/en/commands | /code-review command syntax and background-task relationship |

Total scope: 2 pages should describe the same background execution contract.

The behavior was changed in Claude Code v2.1.218.