Contributing to adk-samples
July 23, 2026 · View on GitHub
adk-samples is a curated collection of runnable ADK agent examples.
A recipe is one such example — a focused, self-contained agent
that lives under contrib/ and demonstrates one concrete ADK pattern.
Who reads your recipe? ADK developers looking for a starting
point or pattern to adapt — and coding agents (AI coding assistants)
reading your recipe on a user's behalf. Both benefit from clear
structure and a focused README.md.
What makes a recipe good? A clear purpose, a concrete problem it solves, and something new to teach. Before writing code, make sure you can answer: "What does this recipe demonstrate, and who benefits?" If the answer isn't clear, the recipe needs more focus. Recipes that duplicate existing examples without adding new insight may not be accepted.
Contributing gives you visibility in the ADK community and helps other developers learn from your work. The more focused and well-documented your recipe is, the more useful it becomes.
Start here
recipe-checklist.md— the one-page checklist. Everything you need to submit a recipe.recipe-handbook/— deep detail. Read once when you're new; return when a checklist item needs more explanation.
For contributors
Go straight to recipe-checklist.md.
It links out to handbook pages when you need more detail.