[DOCS] Commands docs still describe removed `/simplify` behavior instead of `/code-review`

Resolved 💬 3 comments Opened May 21, 2026 by coygeek Closed May 23, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

Commands across a typical workflow and the /simplify [focus] command entry

Current Documentation

The docs currently say:

Before you ship. /diff shows what changed, /simplify reviews recent files and applies quality and efficiency fixes, and /review or /security-review give a deeper read-only pass. /simplify [focus] | Skill. Review your recently changed files for code reuse, quality, and efficiency issues, then fix them. Spawns three review agents in parallel, aggregates their findings, and applies fixes. Pass text to focus on specific concerns: /simplify focus on memory efficiency

Related docs also still say:

Prompt-based playbooks included with Claude Code, such as /batch, /simplify, /debug, and /loop. Claude Code includes a set of bundled skills that are available in every session, including /simplify, /batch, /debug, /loop, and /claude-api.

What's Wrong or Missing?

Changelog v2.1.147 says:

Renamed /simplify to /code-review. It now reports correctness bugs at a chosen effort level (e.g., /code-review high); pass --comment to post findings as inline GitHub PR comments. The old cleanup-and-fix behavior has been removed

A. The commands reference still documents the removed /simplify name

The primary command docs still tell users to run /simplify, so the current slash command rename is not reflected in the place users look up command syntax.

B. The documented behavior is the pre-v2.1.147 workflow

The current text says the command fixes reuse/quality/efficiency issues and applies changes automatically. That contradicts v2.1.147, where the command now reports correctness bugs and no longer does cleanup-and-fix work.

C. The new invocation details are missing

The docs do not document the current /code-review <effort> form or the --comment option for posting findings as inline GitHub PR comments.

Suggested Improvement

Update the commands reference and bundled-skill references to match v2.1.147.

Before:

/simplify [focus] ... review your recently changed files for code reuse, quality, and efficiency issues, then fix them.

After:

/code-review [effort] [--comment] | Skill. Review recent changes for correctness bugs at a chosen effort level, for example /code-review high. Add --comment to post findings as inline GitHub PR comments. This command reports findings only; the old cleanup-and-fix workflow has been removed.

Also update the narrative and bundled-skill lists on related pages so they stop advertising /simplify as the current command name.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 25, 112 | Still tells users to run /simplify and says it applies fixes |
| https://code.claude.com/docs/en/skills | 14, 23 | Bundled skills list still names /simplify |
| https://code.claude.com/docs/en/glossary | 59 | Bundled skills glossary example still names /simplify |
| https://code.claude.com/docs/en/features-overview | 246 | Skills overview still lists /simplify as a bundled skill |

Total scope: 4 pages affected

There is already a separate https://code.claude.com/docs/en/code-review page for the GitHub Code Review product, so the command reference should explicitly document the slash command rename and behavior to avoid conflating the two.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗