| name | plan-review |
| description | Get Google Antigravity's (`agy`) review of Claude's implementation plans. Trigger when user wants a second opinion on a plan ("have agy review this plan", "get a second opinion from Google Antigravity", "critique this plan with agy"), or after Claude creates a plan file that needs validation before implementation. Replaces the deprecated gemini-cli plan-review workflow. |
Plan Review via Google Antigravity (agy)
Have Google's Antigravity CLI critique Claude's implementation plans for a second
perspective. agy is Google's successor to gemini-cli and runs Google's Gemini
models.
Why This Skill Differs From gemini-cli's
Google Antigravity does not read prompt input from stdin and cannot read files
outside its workspace. Plans typically live under ~/.claude/plans/, so the
cat plan.md | gemini pattern doesn't apply. Instead, copy the plan into the workspace
or add the plans directory to agy's workspace.
Quick Start
Copy the plan into the workspace, run review, clean up:
cp ~/.claude/plans/example-plan.md ./agy-plan.md
agy --print "Review the implementation plan in agy-plan.md.
Consider:
1. Are there gaps or missing steps?
2. Are there risks not addressed?
3. Is the approach optimal?
4. What alternatives should be considered?
Do not make any changes. Respond with feedback only." --dangerously-skip-permissions
rm ./agy-plan.md
Alternative: extend the workspace instead of copying:
agy --add-dir ~/.claude/plans \
--print "Review the implementation plan at ~/.claude/plans/example-plan.md.
Do not make any changes. Respond with feedback only." \
--dangerously-skip-permissions
Google Antigravity has no --allowed-tools flag — the "Do not make any changes"
clause is what keeps the call read-only.
With Source Context
agy can read files within the workspace, so Google Antigravity can pull source code
context while reviewing:
cp ~/.claude/plans/auth-refactor.md ./agy-plan.md
agy --print "Review the implementation plan in agy-plan.md.
Also read these source files for context:
- src/auth/login.ts
- src/middleware/session.ts
Evaluate whether the plan addresses the actual codebase structure. Do not make any changes. Respond with feedback only." --dangerously-skip-permissions
rm ./agy-plan.md
Focused Reviews
Risk assessment:
cp ~/.claude/plans/migration.md ./agy-plan.md
agy --print "Review agy-plan.md for risks:
- Breaking changes
- Data loss potential
- Rollback complexity
- Dependencies that could fail
Do not make any changes. Respond with feedback only." --dangerously-skip-permissions
rm ./agy-plan.md
Completeness check:
cp ~/.claude/plans/feature.md ./agy-plan.md
agy --print "Review agy-plan.md for completeness:
- Are all edge cases covered?
- Is testing addressed?
- Are there missing steps?
Do not make any changes. Respond with feedback only." --dangerously-skip-permissions
rm ./agy-plan.md
Multi-turn Review
Use --continue to drill into Google Antigravity's critique:
cp ~/.claude/plans/migration.md ./agy-plan.md
agy --print "Review agy-plan.md for risks. Do not make any changes. Respond with feedback only." --dangerously-skip-permissions
agy --continue --print "For the highest-risk items, suggest mitigations. Do not make any changes. Respond with feedback only." --dangerously-skip-permissions
rm ./agy-plan.md
Notes
- Google Antigravity must not make any changes; provide feedback ONLY.
- Plans must be inside the workspace (copy in or use
--add-dir); agy cannot read stdin or arbitrary paths.
- Choose a temp name that won't collide with project files (
agy-plan.md is reasonable). Always rm it after.
agy respects .gitignore — it cannot read files matching gitignore patterns.- Requires
dangerouslyDisableSandbox: true on the Bash tool because Google Antigravity writes session state under ~/.gemini/ (shared with the old gemini-cli).
- May take 2–3 minutes for thorough review with source analysis; bump
--print-timeout if needed (use a unit, e.g. --print-timeout 10m).
- See
references/setup.md and references/patterns.md for more.
