Google Cloud ADK Application Workflow
Overview
Guide a Google ADK application through its current lifecycle: inspect, scaffold, run, evaluate, deploy, publish, and observe. Prefer Google's actively maintained agents-cli. Agent Starter Pack is in maintenance mode and should be treated as a migration source, not the default for new work.
This skill creates Google-hosted agent applications. It does not create Claude Code subagent definition files; route those requests to agent-creator.
Prerequisites
- Identify whether the target is new, an existing ADK app, or an Agent Starter Pack project that needs migration.
- Confirm the local project path and read its instructions.
- For current-version questions, use
WebFetch on official Google documentation or WebSearch restricted to official Google domains.
- For existing code, use
Glob, Grep, and Read to establish its actual framework, configuration, tests, and deployment lane before recommending work.
- Do not require Google Cloud for local development; AI Studio credentials may support a local-only workflow. Cloud deployment does require a Google project.
Instructions
- Classify the request as build, enhance, evaluate, deploy, publish, observe, or migrate. State which lifecycle stage is in scope.
- Inspect the local repository before proposing changes. Preserve working agent code, evaluation datasets, Terraform, and CI/CD during migrations.
- Verify current CLI syntax from the installed command or official docs. Start from these maintained entry points:
uvx google-agents-cli setup
agents-cli create PROJECT_NAME
agents-cli scaffold enhance
agents-cli scaffold upgrade
- For implementation guidance, define the ADK agent, tools, state, callbacks, error contracts, and tests before selecting infrastructure. Use the detailed lifecycle reference for current command families.
- Validate locally with the generated project's own commands. Current
agents-cli releases expose install, lint, run, and the eval command group. Do not claim success without the actual command receipt.
- For deployment, distinguish Agent Runtime, Cloud Run, and GKE. Inspect
agents-cli deploy --help for the installed version and present project, region, identity, secrets, APIs, quotas, and rollback before any mutation.
- For Gemini Enterprise registration, use the current
publish gemini-ent…