adk-dev-guide

What problem does it solve?

Provides a single, prescriptive development workflow and mandatory coding guidelines that prevent unintended changes, reduce iteration waste, and ensure ADK agents meet spec-driven quality and evaluation thresholds.

Core Features & Use Cases

• Spec-first development: Directs developers to read DESIGN_SPEC.md as the primary source of truth and align implementation decisions to the spec.
• Code preservation rules: Defines surgical edit practices so only targeted lines change and unrelated code, configuration, and model settings are preserved.
• Evaluation-first lifecycle: Mandates iterative adk eval workflows, starting small and expanding test coverage only after core cases pass.
• Troubleshooting & deployment guardrails: Covers model selection rules, location troubleshooting, tool import precision, loop-breaking heuristics, and the requirement for explicit human approval before deploy.
• Use case: Onboard a new ADK developer to implement an agent feature, run focused evaluations, fix failures, and prepare a safe deploy pipeline.

Quick Start

Read the project's DESIGN_SPEC.md, then implement changes with surgical precision, run adk eval for iterative evaluation, and obtain explicit human approval before deploying.