adk-dev-guide
Originally fromeliasecchig/adk-skills
Installation
Summary
Essential reference guide for ADK agent development, covering spec-driven workflow, code preservation rules, and operational best practices.
- Read
DESIGN_SPEC.mdfirst as your primary source of truth; all implementation decisions must align with it - Follow four mandatory phases: understand spec, build and implement, evaluate (using
/adk-eval-guide), and deploy with human approval - Preserve all unrelated code when making modifications; only alter explicitly targeted segments and never change model names unless requested
- Use Gemini 3 series models (
gemini-3-flash-preview,gemini-3-pro-preview) for new agents; fix location issues (not model names) when encountering 404 errors - Stop immediately after three consecutive identical errors; fix root causes (tool bugs, state conflicts, location mismatches) before retrying operations
SKILL.md
ADK Development Workflow & Guidelines
Session Continuity
If this is a long session, re-read the relevant skill before each phase —
/adk-cheatsheet before writing code, /adk-eval-guide before running evals,
/adk-deploy-guide before deploying, /adk-scaffold before scaffolding.
Context compaction may have dropped earlier skill content.
DESIGN_SPEC.md — Your Primary Reference
IMPORTANT: If DESIGN_SPEC.md exists in this project, it is your primary source of truth.
Read it FIRST to understand:
- Functional requirements and capabilities
- Success criteria and quality thresholds
- Agent behavior constraints
Related skills