[DOCS] `/code-review` command docs still describe pre-`--fix` behavior and outdated `/simplify` aliasing

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

/code-review entry in the commands table, plus the local-terminal note on the Code Review page

Current Documentation

The commands page currently says:

/code-review [low|medium|high|xhigh|max] [--comment] [target] ... Review the current diff for correctness bugs and report findings without editing files. ... Pass --comment to post findings as inline comments on the current GitHub PR. Pass a path or PR reference to review a specific target. Formerly /simplify, which still works as an alias

The Code Review page currently says:

To review a diff locally in your terminal without installing the GitHub App, run the /code-review command in any Claude Code session. It reports correctness bugs in the current diff at a chosen effort level and can post findings as inline PR comments with --comment. The command was named /simplify before v2.1.147.

But the v2.1.152 changelog says:

/code-review --fix now applies review findings to your working tree after the review, surfacing reuse, simplification, and efficiency suggestions; /simplify now invokes /code-review --fix

What's Wrong or Missing?

A. /code-review behavior is outdated

The current command reference still describes /code-review as review-only and explicitly says it reports findings "without editing files," but v2.1.152 adds a --fix mode that applies review findings to the working tree after the review.

B. /simplify behavior is outdated

The docs still describe /simplify as the old name or a general alias for /code-review. In v2.1.152, /simplify now specifically invokes /code-review --fix, which is a narrower and more actionable behavior than a plain alias to the read-only review flow.

Suggested Improvement

Update the /code-review entry in https://code.claude.com/docs/en/commands to document the --fix flag explicitly, including that it applies review findings to the working tree after the review and can surface reuse, simplification, and efficiency suggestions in addition to correctness findings.

Update https://code.claude.com/docs/en/code-review so the local-terminal note distinguishes:

• /code-review for review behavior
• /code-review --fix for applying findings to the working tree
• /simplify as the shorthand that now invokes /code-review --fix

If the docs team wants to preserve the history, note that /simplify was previously renamed to /code-review in v2.1.147, but clarify that its behavior changed again in v2.1.152.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 53 | /code-review still says it reports findings without editing files and says /simplify is an alias |
| https://code.claude.com/docs/en/code-review | 29 | Local-terminal note still describes the pre-v2.1.152 behavior |

Total scope: 2 pages affected

This issue is about documentation drift introduced by the v2.1.152 command-behavior change: --fix now applies findings to the working tree, and /simplify now routes to that fix flow.