Gemini Research Subagent

You have access to Gemini CLI as a large-context research assistant. Use Gemini for reading large codebases, use yourself for implementation.

When to Invoke Gemini

ALWAYS use Gemini BEFORE:

Reading files >100 lines
Understanding unfamiliar code areas
Tracing bugs across multiple files
Making changes that affect multiple components
Performing security or architecture reviews

DO NOT use Gemini for:

Simple single-file edits you can handle
Writing code (that's your job)
Files you've already analyzed this session

How to Invoke

./skills/gemini.agent.wrapper.sh -d "@src/" "Your research question"

Available Roles (loaded from `.gemini/roles/`)

| Role | Command | Use Case | |------|---------|----------| | reviewer | -r reviewer | Code quality, bugs, security | | debugger | -r debugger | Bug tracing, root cause analysis | | planner | -r planner | Architecture, implementation planning | | security | -r security | Security vulnerabilities audit | | auditor | -r auditor | Codebase-wide analysis | | explainer | -r explainer | Code explanation | | migrator | -r migrator | Migration planning | | documenter | -r documenter | Documentation generation | | dependency-mapper | -r dependency-mapper | Dependency analysis | | onboarder | -r onboarder | Onboarding guide |

Custom Roles

Add custom roles in .gemini/roles/<name>.md. Examples: | Role | Focus | |------|-------| | kotlin-expert | Kotlin/Android, coroutines | | typescript-expert | TypeScript type safety | | python-expert | Python async, type hints | | api-designer | REST API design | | database-expert | Query optimization |

Templates

# Implementation-ready output
./skills/gemini.agent.wrapper.sh -t implement-ready -d "@src/" "Add user profiles"

# Fix-ready output for bugs
./skills/gemini.agent.wrapper.sh -t fix-ready "Login fails with 401"

# Post-implementation verification
./skills/gemini.agent.wrapper.sh -t verify --diff "Added password reset"

Response Format

Gemini returns structured output you can parse:

## SUMMARY
[1-2 sentence overview]

## FILES
[file:line references]

## ANALYSIS
[detailed findings]

## RECOMMENDATIONS
[actionable items]

Workflow Pattern

Research: Invoke Gemini to understand context
Implement: You write code based on Gemini's analysis
Verify: Invoke Gemini to verify your changes

Example Usage

# Pre-implementation research
./skills/gemini.agent.wrapper.sh -r planner -d "@src/" "How should I add caching?"

# Post-implementation verification
./skills/gemini.agent.wrapper.sh -t verify --diff "Added caching layer"