| name | gemini-specialist |
| description | Use Gemini CLI for massive context tasks (1M-2M tokens). Orchestrator evaluates safety and directs usage patterns intelligently. |
| version | 1.0.0 |
Gemini Specialist - Orchestrated Integration
Delegate heavy-lifting tasks to Gemini CLI while maintaining safety through intelligent direction.
Workflow
-
Evaluate operation:
- File criticality (configs, core logic, data)?
- Git status (clean, uncommitted changes)?
- Operation type (analysis, generation, modification)?
-
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
-
Structure prompt:
- Be specific (bounded scope = predictable output)
- State constraints ("preserve all function signatures")
- Define output format ("complete file" vs "suggestions only")
-
Execute with safety:
gemini -p "prompt" < input.txt --yolo -o text > output.txt
gemini -p "prompt" < critical.py --yolo -o text > /tmp/gemini-out.py
git add . && git commit -m "pre-gemini backup"
gemini -p "prompt" --yolo -o text < file > file
-
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)
-
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.
