[DOCS] Ultrareview documentation omits the no-merge-base fallback

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/ultrareview

Section/Topic

“Run ultrareview from the CLI,” especially the default branch/base comparison behavior.

Current Documentation

The page currently says:

Start a review from any git repository in the Claude Code CLI.

and:

Without arguments, ultrareview reviews the diff between your current branch and the default branch, including any uncommitted and staged changes in your working tree.

What's Wrong or Missing?

Claude Code 2.1.214 changes ultrareview behavior when the repository has no merge base: it now offers to review all tracked files. The documentation describes only the normal branch/default-branch diff and does not explain what happens when no common ancestor exists, what scope “all tracked files” means, or what confirmation the user receives before uploading that larger scope.

Users working in newly initialized repositories, unrelated histories, or unusual branch setups may interpret the fallback as a failure or may not realize that the review scope changes substantially.

Suggested Improvement

Add a note to the CLI workflow describing the fallback:

~~~text
If the current branch and the default branch have no merge base, Claude Code cannot compute the normal diff. In Claude Code 2.1.214 and later, ultrareview offers to review all tracked files instead. Explain how to accept or decline the expanded scope, whether untracked files are excluded, and that the confirmation dialog shows the resulting file/line scope before the review is uploaded.
~~~

Add an equivalent note to the non-interactive command documentation, including the exit behavior when the fallback requires confirmation that cannot be provided non-interactively.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/ultrareview | Interactive and non-interactive review scope |
| https://code.claude.com/docs/en/cli-reference | claude ultrareview command reference |

Release: Claude Code 2.1.214.