<!-- word count: 195 (target 100, cap 200) -->

# Contributing to adk-samples

`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`](./recipe-checklist.md)** — the
  one-page checklist. Everything you need to submit a recipe.
- **[`recipe-handbook/`](./recipe-handbook/README.md)** — deep
  detail. Read once when you're new; return when a checklist
  item needs more explanation.

## For contributors

Go straight to [`recipe-checklist.md`](./recipe-checklist.md).
It links out to handbook pages when you need more detail.

---

[Checklist](./recipe-checklist.md) · [Handbook](./recipe-handbook/README.md)
