google-agents-cli-workflow

Installation
Summary

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)
SKILL.md

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.

Installs
14.2K
GitHub Stars
2.9K
First Seen
Apr 21, 2026
google-agents-cli-workflow — google/agents-cli