Gemini System — Research & Multimodal Specialist

Gemini CLI (latest: Gemini 3 Pro/Flash, stable: Gemini 2.5 series) is your research specialist with 1M token context

Detailed rules: .claude/rules/gemini-delegation.md

Context Management (CRITICAL)

Prefer Subagent Pattern

Gemini vs Codex

When to Consult (MUST)

When NOT to Consult

• Design decisions (use Codex)
• Debugging (use Codex)
• Code implementation (use Codex)
• Simple file operations (do directly)

How to Consult

Recommended: Subagent Pattern

Use Task tool with subagent_type='general-purpose' to preserve main context

Task tool parameters:
- subagent_type: "general-purpose"
- run_in_background: true (optional, for parallel work)
- prompt: |
    Research: {topic}

    gemini -p "{research question}" 2>/dev/null

    Save full output to: .claude/docs/research/{topic}.md
    Return CONCISE summary (5-7 bullet points).

Direct Call (Short Questions Only)

For quick questions expecting brief answers:

gemini -p "Brief question" 2>/dev/null

CLI Options Reference

# Codebase analysis
gemini -p "{question}" --include-directories . 2>/dev/null

# Multimodal (PDF/video/audio)
gemini -p "{prompt}" < /path/to/file.pdf 2>/dev/null

# JSON output
gemini -p "{question}" --output-format json 2>/dev/null

Workflow (Subagent)

1. Spawn subagent with Gemini research prompt
2. Continue your work → Subagent runs in parallel
3. Receive summary → Subagent returns key findings
4. Full output saved → .claude/docs/research/{topic}.md

Language Protocol

1. Ask Gemini in English
2. Receive response in English
3. Synthesize and apply findings
4. Report to user in their preferred language

Output Location

Save Gemini research results to:

.claude/docs/research/{topic}.md

This allows Claude and Codex to reference the research later.

Task Templates

Pre-Implementation Research

gemini -p "Research best practices for {feature} in Python 2025.
Include:
- Common patterns and anti-patterns
- Library recommendations (with comparison)
- Performance considerations
- Security concerns
- Code examples" 2>/dev/null

Repository Analysis

gemini -p "Analyze this repository:
1. Architecture overview
2. Key modules and responsibilities
3. Data flow between components
4. Entry points and extension points
5. Existing patterns to follow" --include-directories . 2>/dev/null

Library Research

See: references/lib-research-task.md

Multimodal Analysis

# Video
gemini -p "Analyze video: main concepts, key points, timestamps" < tutorial.mp4 2>/dev/null

# PDF
gemini -p "Extract: API specs, examples, constraints" < api-docs.pdf 2>/dev/null

# Audio
gemini -p "Transcribe and summarize: decisions, action items" < meeting.mp3 2>/dev/null

Integration with Codex

Why Gemini?

• 1M token context: Entire repositories at once
• Google Search: Latest information and docs
• Multimodal: Native PDF/video/audio processing
• Fast exploration: Quick overview before deep work
• Shared context: Results saved for Claude/Codex