The Core Update
Google has restructured its ADK samples into a unified repository named google/adk-recipes. This move replaces the previous fragmented collection with a centralized source of truth designed for machine readability. The repo is organized into three distinct layers: core/ for reference patterns, plugins/ for modular vertical skills, and contrib/ for end-to-end deployable services. Official Source: Google Announcement
Technical Impact & Mechanism
The shift prioritizes AI agents over human developers as the primary consumers of documentation. Every recipe now requires a manifest.yaml and an AGENTS.md file, alongside Dockerfiles and tests. This structure enables coding assistants to autonomously discover, scaffold, and validate production-ready services.
Key structural breakdown:
- core/: Pattern library for the Agents CLI.
- plugins/: Vertical skills compliant with Agent Plugins v1.0.0.
- contrib/: Multi-language deployments for Cloud Run and Agent Runtime.
Developers can now leverage automated tooling to manage the lifecycle of these agents. For example, triggering a build process against a specific recipe looks like this:
# Example of scaffold-to-deploy workflow
adk-cli init --recipe=contrib/gemini-service
adk-cli validate --manifest=manifest.yaml
adk-cli deploy --target=cloud-run
Action Plan for Developers & Businesses
- Audit Agent Workflows: Transition existing sample-based builds to the new
adk-recipesstructure to ensure compatibility with updated Agent Platform surfaces. - Adopt Machine-Readable Docs: Begin authoring
AGENTS.mdandmanifest.yamlfiles for internal services. This forces strict interface definitions, making your services discoverable by autonomous coding assistants. - Integrate CI Validations: Align your internal testing pipelines with the new structure. Ensure every custom plugin or service includes a
Dockerfileand a runnability test to pass the repo's automated checks.
> Waleed Raza | Digital Systems Architect > Helping teams build faster through high-performance engineering. > Check out my latest case studies or let's connect to optimize your stack.