Gemini-Claude Engineering Loop
Workflow Overview
code
Plan (Claude) → Validate (Gemini) → Implement (Claude) → Review (Gemini) → Fix → Re-validate → Done
| Role | Responsibility |
|---|---|
| Claude | Architecture, planning, code implementation (Edit/Write/Read) |
| Gemini | Validation, code review, quality assurance |
Environment Notice
Non-TTY environment: See gemini-cli SKILL for CLI fundamentals. Key rule: Always use
gemini -p "prompt"(headless mode required)
Phase 0: Pre-flight Check
- •Create context directory:
mkdir -p .gemini-loop - •Ask user via
AskUserQuestion:- •Model preference (gemini-3-flash-preview (default), gemini-3-pro-preview (complex only))
- •Role mode preference (Review-Only OR Review+Suggest)
Phase 1: Planning (Claude)
- •Create detailed implementation plan
- •Break down into clear steps
- •Document assumptions and risks
- •Save to
.gemini-loop/plan.md
Phase 2: Plan Validation (Gemini)
Ask user for role mode, then execute with timeout: 600000:
bash
gemini -m gemini-3-flash-preview -p "Review this plan: $(cat .gemini-loop/plan.md) ..."
Full prompts by role mode: See commands.md
Save result: > .gemini-loop/phase2_validation.md
Phase 3: Feedback Loop
If issues found:
- •Summarize Gemini feedback to user
- •Ask via
AskUserQuestion: "Revise and re-validate, or proceed?" - •If revise → Update plan → Repeat Phase 2
Phase 4: Implementation (Claude)
- •Implement using Edit/Write/Read tools
- •Execute step-by-step with error handling
- •Save summary to
.gemini-loop/implementation.md
Phase 5: Code Review (Gemini)
Execute with timeout: 600000:
bash
gemini -m gemini-3-flash-preview --include-directories ./src -p "Review: $(cat .gemini-loop/plan.md) $(cat .gemini-loop/implementation.md) ..."
Full prompts by role mode: See commands.md
Save result: > .gemini-loop/phase5_review.md
Claude response by severity:
- •Critical → Fix immediately
- •Architectural → Discuss with user
- •Minor → Document and proceed
Phase 6: Iteration
- •Apply fixes from
.gemini-loop/phase5_review.md - •Significant changes → Re-validate with Gemini
- •Loop until quality standards met
Context Files
code
.gemini-loop/ ├── plan.md # Implementation plan ├── phase2_validation.md # Plan validation result ├── implementation.md # Implementation summary ├── phase5_review.md # Code review result └── iterations.md # Iteration history
Quick Reference
Always use timeout: 600000 (10 min) for all Gemini commands.
References
- •Command patterns & prompts: See references/commands.md
- •Gemini CLI fundamentals: See gemini-cli SKILL (models, options, error handling, timeout, JSON output)