diff --git a/plugins/codex/commands/review.md b/plugins/codex/commands/review.md index fb70a487..cb22e319 100644 --- a/plugins/codex/commands/review.md +++ b/plugins/codex/commands/review.md @@ -24,7 +24,7 @@ Execution mode rules: - For base-branch review, use `git diff --shortstat ...HEAD`. - Treat untracked files or directories as reviewable work even when `git diff --shortstat` is empty. - Only conclude there is nothing to review when the relevant working-tree status is empty or the explicit branch diff is empty. - - Recommend waiting only when the review is clearly tiny, roughly 1-2 files total and no sign of a broader directory-sized change. + - Recommend waiting when the review is small, roughly up to 5 files or about 200 insertions+deletions as reported by `git diff --shortstat`, with no sign of a broader directory-sized change. Codex finishes within Claude's prompt cache window (5 minutes) for changes of this size, so wait in the foreground and the result feeds the next step. - In every other case, including unclear size, recommend background. - When in doubt, run the review instead of declaring that there is nothing to review. - Then use `AskUserQuestion` exactly once with two options, putting the recommended option first and suffixing its label with `(Recommended)`: