How to split Claude Code reviews: /code-review for bugs, /simplify for cleanup
Starting with Claude Code 2.1.328 (November 19), /code-review reports only bugs and CLAUDE.md violations on most models. Cleanup suggestions such as reusing existing helpers, simplification and efficiency now belong to /simplify.
- When a change is done, check for bugs first. Add
--fixto have Claude apply the findings right away.
/code-review
/code-review high --fix
-
Each finding is marked Important, Pre-existing or Nit, and each summary ends with a suggested fix. Pre-existing means the problem was there before this change. A clean review reads "Code review found no issues."
-
Once the bugs are handled, run
/simplify. Four agents look at reuse, simplification, efficiency and level of abstraction, then apply the fixes; they don't look for bugs. Pass a path or PR to review just that target.
/simplify
/simplify src/parser
Before v2.1.147, /simplify did what /code-review --fix does now. If an old script uses /simplify to find bugs, switch it to /code-review --fix. The /code-review docs page still says cleanups may be included depending on model and effort; the 2.1.328 changelog is where that changed.
Sources
Get notified when a new tip lands
Tip alerts only go out in the app. Install it and turn notifications on.