gemini-review-plan

Gemini Plan Review

Send the current plan to Gemini CLI for an independent review. Gemini runs in plan (read-only) approval mode to ensure no file modifications.

Workflow

Step 1: Locate the Plan File

Determine which plan to review:

• If the user specified a file path, use that path directly.
• Otherwise, find the most recently modified plan file:

ls -t ~/.claude/plans/*.md 2>/dev/null | head -1

If no plan file is found, inform the user that no plan was found and ask them to specify a path.

Read the plan file to confirm it has content before proceeding.

Step 2: Execute Gemini Review

Run the Gemini CLI in non-interactive headless mode with plan (read-only) approval. Use a 5-minute timeout since model inference can take time.

gemini --approval-mode plan -o text \
  -p "You are reviewing an implementation plan. Analyze it for:
- Logical gaps or missing steps
- Incorrect assumptions about the codebase or dependencies
- Risks and potential failure modes
- Ordering issues (steps that should come earlier or later)
- Missing error handling or edge cases
- Opportunities for simplification

Be specific and actionable. Reference specific sections of the plan in your feedback." \
  < <plan-file-path> > /tmp/gemini-plan-review.md 2>&1

Set Bash timeout to 300000 (5 minutes).

Step 3: Present Results

Read /tmp/gemini-plan-review.md and present the review to the user.

Filter out any Gemini CLI chrome or status lines — present only the model's review content.

Format the output with a clear header:

## Gemini Plan Review

<review content>

Clean up the temp file:

rm -f /tmp/gemini-plan-review.md

Error Handling

• If gemini is not found: inform the user to install Gemini CLI (npm install -g @anthropic-ai/gemini or similar)
• If gemini returns an error: show the error and suggest checking authentication
• If the plan file is empty: inform the user and do not invoke gemini