ADK Project Scaffolding Guide

Project scaffolding, deployment configuration, and CI/CD setup for Google ADK agents.

- Covers three main commands: scaffold create for new projects, scaffold enhance to add deployment and CI/CD to existing projects, and scaffold upgrade to apply version updates while preserving customizations

- Supports three agent templates (standard ADK, agent-to-agent A2A, and agentic RAG) with deployment targets including Agent Runtime, Cloud Run, and GKE

- Enforces a prototype-first workflow: start with --prototype to skip infrastructure, iterate on agent code, then add deployment later via enhance

- Requires clarifying user requirements before scaffolding; project names must be 26 characters or less with lowercase letters, numbers, and hyphens only

ADK Project Scaffolding Guide

Requires: agents-cli (uv tool install google-agents-cli) - install uv first if needed.

Use the agents-cli CLI to create new ADK agent projects or enhance existing ones with deployment, CI/CD, and infrastructure scaffolding.

Prerequisite: Clarify Requirements (MANDATORY for new projects)

Before scaffolding a new project, load /google-agents-cli-workflow and complete Phase 0 - clarify the user's requirements before running any scaffold create command. Ask what the agent should do, what tools/APIs it needs, and whether they want a prototype or full deployment.

Step 1: Choose Architecture

Mapping user choices to CLI flags: