name: gemini-system description: | PROACTIVELY consult Gemini CLI for research, large codebase comprehension, and multimodal data processing. Gemini excels at: massive context windows (1M tokens), Google Search grounding, video/audio/PDF analysis, and repository-wide understanding. Use for pre-implementation research, documentation analysis, and multimodal tasks. Explicit triggers: "research", "investigate", "analyze video/audio/PDF", "understand codebase". metadata: short-description: Claude Code ↔ Gemini CLI collaboration (research & multimodal)

Gemini System — Research & Multimodal Specialist

Gemini CLI (gemini-3-pro-preview) is your research specialist with 1M token context.

상세규칙: .claude/rules/gemini-delegation.md

Context Management (CRITICAL)

서브에이전트 경유 권장한다. Gemini 출력은 커지기 쉽기 때문에.

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 Korean

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