[DOCS] Ultrareview docs do not explain descriptive arguments as review notes

Status Fixed / completed
Reported on v2.1.218
Maintainer reply None cached
Activity 1 comment · opened Jul 23, 2026 · closed Aug 16, 2026

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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗