gemini-agent-sdk

Gemini Agent SDK / Gemini Workflow Adapter

Use this skill when implementing a Gemini-backed runner for a workflow that also exists for Cursor, OpenCode, Claude, or OpenAI. This repo currently packages Gemini CLI skills/commands, so a Gemini workflow adapter should be added deliberately and kept compatible with the shared workflow contract.

Local references

• docs/gemini-cli-setup.md documents current Gemini CLI packaging.
• agents/research-runner/ shows the multi-runtime runner pattern to mirror.
• agents/research-runner/shared/ should hold reusable prompts, templates, and output code.

Workflow adapter contract

Shared types: agents/research-runner/shared/workflow-contract.ts (WorkflowInput, WorkflowResult, optional safetyNotes).

No Gemini runner exists yet. Add agents/research-runner/gemini/runner.ts (or a new workflow folder) implementing this contract; keep .gemini/skills as CLI distribution only.

Implementation rules

1. Use official Gemini docs for current SDK names and APIs. Do not rely on memory for package names, auth, tool-calling, or streaming semantics.
2. Mirror the existing runner layout. Add agents/<workflow>/gemini/runner.ts or equivalent beside the other harness variants.
3. Keep CLI packaging separate. .gemini/skills and .gemini/commands are distribution assets; SDK workflow runners are executable code.
4. Use structured responses for machine decisions. Parse JSON for handoffs, verdicts, and next actions.
5. Treat safety blocks as workflow states. Return blocked with the exact model/safety reason instead of retrying blindly.
6. Verify claims outside the model. File checks, git checks, and test commands belong to deterministic runner code.
7. Keep prompts shared. Only put Gemini-specific prompt adaptations in the Gemini adapter.

Good fits

• Research and synthesis variants
• Provider comparison workflows
• Workflows where Gemini is selected by model policy

Poor fits

• Repo mutation without a local verification harness
• Assuming Gemini CLI skills are the same thing as a Gemini SDK runner