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.