ADK Development Workflow & Guidelines

Complete workflow for scaffolding, building, evaluating, and deploying agents using Google's Agent Development Kit.

- Covers all seven phases: understanding requirements, studying reference samples, scaffolding projects, implementing agent logic, evaluation, deployment, and observability

- Includes mandatory Phase 0 clarification questions (problem statement, APIs, safety constraints, deployment preference) and a spec template to document decisions before coding

- Provides phase-specific CLI commands (agents-cli scaffold create, agents-cli run, agents-cli eval run, agents-cli deploy) and cross-references to related skills for deep dives into code patterns, evaluation methodology, and infrastructure

- Enforces code preservation (modify only targeted segments, never change models or config without explicit request) and systematic debugging (reproduce, localize, fix one thing, verify, guard)

ADK Development Workflow & Guidelines

STOP - Do NOT write code yet. If no project exists, scaffold first with agents-cli scaffold create <name>. If the user already has code, use agents-cli scaffold enhance . to add the agents-cli structure. Run agents-cli info to check if a project already exists. Skipping this leads to missing eval boilerplate, CI/CD config, and project conventions.

agents-cli is a CLI and skills toolkit for building, evaluating, and deploying agents on Google Cloud using the Agent Development Kit (ADK). It works with any coding agent - Gemini CLI, Claude Code, Codex, or others. Install with uvx google-agents-cli setup.

Requires: google-agents-cli = 0.4.0
If version is behind, run: uv tool install "google-agents-cli=0.4.0"

Check version: agents-cli info
Install uv first if needed.

Session Continuity & Skill Cross-References

Re-read the relevant skill before each phase - not after you've already started and hit a problem. Context compaction may have dropped earlier skill content. If skills are not available, run uvx google-agents-cli setup to install them.