[DOCS] Commands docs still describe removed `/simplify` behavior instead of `/code-review`
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./diffshows what changed,/simplifyreviews recent files and applies quality and efficiency fixes, and/reviewor/security-reviewgive 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/simplifyto/code-review. It now reports correctness bugs at a chosen effort level (e.g.,/code-review high); pass--commentto 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--commentto 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.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗