[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.
3 Comments
Found 1 possible duplicate issue:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
Issue #61322 Verification
Title: [DOCS] Commands docs still describe removed
/simplifybehavior instead of/code-reviewIssue Date: Unknown
Verification Date: 2026-05-22
Status: RESOLVED
---
Issue Summary
This issue reports that the commands reference and related bundled-skill pages still documented
/simplifyas the current command, described the pre-v2.1.147 cleanup-and-fix behavior, and omitted the newer/code-review [effort] [--comment]invocation details.---
Verification Results
Claim 1: The commands reference still documents
/simplifyas the current command nameStatus: RESOLVED
At https://code.claude.com/docs/en/commands, line 25: "Before you ship.
/diffshows what changed,/code-reviewchecks the diff for correctness bugs, and/reviewor/security-reviewgive a deeper read-only pass."At https://code.claude.com/docs/en/commands, line 53: "
/code-review [low\|medium\|high\|xhigh\|max] [--comment] [target]... Formerly/simplify, which still works as an alias"Verdict: The commands page now presents
/code-reviewas the primary command name and relegates/simplifyto an alias, so the reported naming problem is no longer present.---
Claim 2: The docs still describe the removed cleanup-and-fix behavior instead of the current review-only behavior
Status: RESOLVED
At https://code.claude.com/docs/en/commands, line 53: "Review the current diff for correctness bugs and report findings without editing files."
At https://code.claude.com/docs/en/commands, line 53: "Lower effort levels return fewer, higher-confidence findings, while
highthroughmaxgive broader coverage and may include uncertain findings."Verdict: The current command description matches the review-only behavior described in the issue and no longer says the command applies cleanup or efficiency fixes automatically.
---
Claim 3: The new
/code-reviewinvocation details and related bundled-skill references are still missingStatus: RESOLVED
At https://code.claude.com/docs/en/commands, line 53: "
/code-review [low\|medium\|high\|xhigh\|max] [--comment] [target]"At https://code.claude.com/docs/en/skills, line 14: "For built-in commands like
/helpand/compact, and bundled skills like/debugand/code-review, see the commands reference"At https://code.claude.com/docs/en/skills, line 23: "Claude Code includes a set of bundled skills that are available in every session, including
/code-review,/batch,/debug,/loop, and/claude-api."At https://code.claude.com/docs/en/glossary, line 59: "Prompt-based playbooks included with Claude Code, such as
/batch,/code-review,/debug, and/loop."At https://code.claude.com/docs/en/features-overview, line 246: "Claude Code includes bundled skills like
/code-review,/batch, and/debugthat work out of the box."Verdict: The commands page now documents the effort-level and
--commentinvocation details, and the related bundled-skill pages referenced in the issue have been updated to use/code-review.---
Current State
| Claim | Status |
|-------|--------|
| Commands reference still uses
/simplifyas the current command | RESOLVED || Commands reference still describes the old cleanup-and-fix behavior | RESOLVED |
|
/code-reviewinvocation details and related bundled-skill references are missing | RESOLVED |---
Suggested Fix
N/A - issue has been resolved.
---
References
/code-reviewinstead of/simplify./code-review [low|medium|high|xhigh|max] [--comment] [target], describes review-only behavior, and notes/simplifyonly as an alias./code-review./code-review./code-review./code-reviewamong bundled skills.---
Conclusion & Recommendation
Primary Concern: The issue reported that current command docs and related bundled-skill pages still exposed the obsolete
/simplifyname and behavior instead of the newer/code-reviewworkflow.Resolution Status: RESOLVED
Recommendation: CLOSE
The current commands reference now documents
/code-reviewas the primary command, includes the effort-level and--commentsyntax, and describes review-only behavior. The related bundled-skill pages cited in the issue also now use/code-review, so the reported documentation gap has been fixed.---
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.