Three layers, one repo: a tour of google/adk-recipes

Summary

The google/adk-recipes repository serves as the single source of truth for ADK content across Google Cloud’s Agent Platform, including the Agents CLI, Agent Garden, and Gemini Enterprise app. It is organized into three top-level folders: core/ with reference patterns curated by the Agents CLI and DevRel teams, plugins/ with installable vertical skills packaged as Plugin Recipes conforming to the Agent Plugins v1.0.0 spec, and contrib/ with end-to-end deployable services in five languages. Every recipe ships a validated manifest.yaml and an AGENTS.md written primarily for AI coding assistants, and CI enforces the standards on every pull request. The core/ layer features Horizon, a reference harness for long-horizon memory agents that handles cross-session memory, per-user sandboxing, guardrails, and multi-step task orchestration. The retail Plugin Recipe includes product-search and virtual-tryon skills using Vector Search 2.0 and Gemini models, with deployable counterparts in contrib/ that can be surfaced on five deployment personas.

Takeaways

1. 1

   The repository is split into three top-level folders: core/ for reference patterns, plugins/ for installable vertical skills packaged as Plugin Recipes, and contrib/ for end-to-end deployable services in five languages.

2. 2

   Every recipe includes an AGENTS.md file written primarily for AI coding assistants, enabling automatic discovery and installation without requiring human reading.

3. 3

   Horizon, in core/, provides a reference harness for building long-horizon memory agents with cross-session memory, per-user sandboxing, guardrails, and resumable multi-step tasks.

FAQ