Gemini Specialist - Orchestrated Integration

Delegate heavy-lifting tasks to Gemini CLI while maintaining safety through intelligent direction.

Workflow

1. Evaluate operation:

   • File criticality (configs, core logic, data)?
   • Git status (clean, uncommitted changes)?
   • Operation type (analysis, generation, modification)?

2. Choose pattern:

   • Low risk (analysis, new files): Direct execution
   • Medium risk (refactoring, critical files): Temp-first review
   • High risk (data files, configs): Git commit + temp-first

3. Structure prompt:

   • Be specific (bounded scope = predictable output)
   • State constraints ("preserve all function signatures")
   • Define output format ("complete file" vs "suggestions only")

4. Execute with safety:

   bashCopy

   # Pattern 1: Direct (low risk)
   gemini -p "prompt" < input.txt --yolo -o text > output.txt
   
   # Pattern 2: Temp-first (medium risk)
   gemini -p "prompt" < critical.py --yolo -o text > /tmp/gemini-out.py
   # Validate, then apply if good
   
   # Pattern 3: Git safety net (high risk)
   git add . && git commit -m "pre-gemini backup"
   gemini -p "prompt" --yolo -o text < file > file
   # If bad: git restore file
   

5. Validate output:

   • Check file integrity (not corrupted, valid syntax)
   • Verify scope (did it modify only what was asked?)
   • Compare if needed (diff old vs new)

6. Report unexpected behavior to user

When to Use

• Large codebase analysis (>100k tokens)
• Documentation review (100+ files)
• Cross-validation (second opinion on critical decisions)
• Architecture planning (high-level design with massive context)
• Real-time research (Google Search grounding)

Gemini Capabilities

• Context: 1M-2M tokens (5-10x Claude)
• Search: Built-in Google Search grounding
• Speed: Fast analysis, slower implementation
• Cost: Free tier (1000 requests/day)

Key Principle

Direction > Prohibition. Evaluate risk, choose pattern, structure prompts. Trust Gemini with proper guidance and safety nets.

See EXAMPLES.md for practical workflows and PATTERNS.md for detailed safety strategies.