[DOCS] Ultrareview docs do not explain descriptive arguments as review notes
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/ultrareview
Section/Topic
The “Run ultrareview from the CLI” argument syntax for /ultrareview and /code-review ultra.
Current Documentation
The page currently says:
To review a GitHub pull request instead, pass the PR number.
It documents branch names, PR numbers, common PR reference forms, and pasted PR URLs, but does not explain how a descriptive argument is interpreted when it is not a branch or pull-request reference.
What's Wrong or Missing?
Claude Code 2.1.218 fixed /ultrareview handling for descriptive arguments such as review my auth changes. These arguments now run a review of the current branch and apply the text as a note to the findings.
The current page teaches users that positional text identifies a branch or PR target, so it does not reveal this useful invocation form or distinguish a descriptive note from a target identifier. Users may also assume that an unrecognized phrase is a branch name and troubleshoot the wrong failure.
Suggested Improvement
Add a subsection or table that distinguishes target arguments from descriptive review notes. Include an example such as:
/ultrareview review my auth changes
Explain that when the argument is descriptive text rather than a supported branch, base, or PR reference, ultrareview reviews the current branch and carries the text into the findings as a note. State whether the same behavior applies to /code-review ultra and to claude ultrareview in non-interactive use.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/ultrareview | Interactive and CLI argument interpretation |
| https://code.claude.com/docs/en/commands | /ultrareview and /code-review ultra command discovery |
| https://code.claude.com/docs/en/code-review | Local/cloud review command relationship |
Total scope: 3 pages should describe the same descriptive-argument contract.
The behavior was changed in Claude Code v2.1.218.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗