adk-dev-guide

Enforce a Phase 1-4 ADK agent development lifecycle with DESIGN_SPEC.md.

9|1|Updated Feb 11, 2026

Search Tags:#workflow #scaffolding #evaluation #best-practices #adk #agent-development #design-spec

Ready to run

npx skills add https://github.com/hq-opensource/si-mapper --skill adk-dev-guide-hq-opensource

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adk-dev-guide
Source: https://github.com/hq-opensource/si-mapper/tree/main/.agents/skills/adk-dev-guide
Command: npx skills add https://github.com/hq-opensource/si-mapper --skill adk-dev-guide-hq-opensource

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a standardized ADK development lifecycle and coding guidelines to ensure consistent, contract-driven agent creation, testing, and deployment practices across teams.

Core Features & Use Cases

Enforces a structured, phase-driven approach (Understand, Build, Evaluate, Deploy) for ADK-based agents.
Centralizes reference materials and troubleshooting procedures (DESIGN_SPEC.md as the primary source) to accelerate development and maintain quality.
Use Case: Teams can onboard new ADK projects quickly by following the guided phases and validation steps.

Quick Start

Read DESIGN_SPEC.md and follow the Phase 1–4 workflow to begin implementing an ADK agent according to the skill guidelines.

Frequently Asked Questions about adk-dev-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

What is the ADK agent development lifecycle and how does it structure project workflows?▼

The ADK agent development lifecycle is a structured, phase-driven workflow encompassing Understand, Build, Evaluate, and Deploy phases. It standardizes agent construction by enforcing contract-driven creation, testing, and deployment practices across teams to maintain consistent quality.

How do I start building an ADK agent using a standardized workflow?▼

To start building an ADK agent, read the DESIGN_SPEC.md file as your primary reference, then follow the Phase 1 to 4 workflow. This structured approach guides you sequentially through design understanding, scaffolding, coding, evaluation, and deployment.

What's the best way to evaluate and test ADK agents during development?▼

The best way to evaluate ADK agents is following the codified guidelines within the Evaluate phase of the lifecycle. This phase mandates specific testing and validation steps to ensure contract-driven agent quality before moving to deployment.

Do I need a design specification document before scaffolding an ADK agent?▼

Yes, reading DESIGN_SPEC.md is required before scaffolding an ADK agent. It serves as the centralized primary reference material, ensuring your project aligns with standardized development guidelines and troubleshooting procedures from the start.

Can I use this ADK workflow for ongoing development cycles or only new agent projects?▼

You can use this ADK workflow for both new agent projects and ongoing development cycles. The phase-driven approach supports continuous design, coding, evaluation, and deployment updates, ensuring consistent practices throughout the agent lifecycle.