Google ADK + A2A: IDP Documentation with 7 agents
What this system is
Section titled “What this system is”google-adk-a2a-idp is a system of 7 specialized agents that autonomously build a complete Internal Developer Platform (IDP). Each agent has a unique responsibility, writes its decisions to shared files via A2A Protocol, and the next one actively reads them — with no direct parameters between agents.
The result: 21 infrastructure files generated in ~4.5 minutes, from Docker Compose to a functional web portal with FastAPI.
The 8 agents in the system
Section titled “The 8 agents in the system”An Orchestrator coordinates the 7 specialized agents. The Orchestrator manages the execution DAG, retries and rollback — but does not execute any infrastructure tasks.
| # | Agent | Responsibility | Output |
|---|---|---|---|
| 0 | Orchestrator | Coordinates DAG, retries (x3) and rollback | orchestration-report.json |
| 1 | Platform Architect | Analyzes the task and decides the full stack | platform-config.yaml |
| 2 | Infrastructure | Reads the Architect’s YAML and generates Docker Compose | docker-compose/app-stack.yml |
| 3 | Security | Scans with Trivy, can block the pipeline | security-report.json |
| 4 | CI/CD | Generates build/test/deploy scripts and Jenkinsfile | cicd/ + Jenkinsfile |
| 5 | Observability | Configures Prometheus + 2 Grafana dashboards | grafana-dashboards/ |
| 6 | DevEx | Generates executable CLI tool with project commands | cli-tool/idp |
| 7 | Web Portal | Builds complete web portal with FastAPI + HTMX | portal/ |
What the system generates
Section titled “What the system generates”A complete run produces 21 files:
test-outputs/idp-adk-sequential/├── platform-config.yaml ← Architect's decisions├── docker-compose/│ └── app-stack.yml ← All services with healthchecks├── security-report.json ← Vulnerabilities and recommendations├── cicd/│ ├── build.sh│ ├── test.sh│ └── deploy.sh├── Jenkinsfile ← Configured CI/CD pipeline├── grafana-dashboards/│ ├── app-metrics.json ← Latency, error rate, throughput│ └── system-metrics.json ← CPU, memory, disk├── cli-tool/idp ← CLI with init/build/test/deploy/status/logs├── portal/ ← Self-service web portal│ ├── main.py│ ├── routes/│ ├── templates/│ └── Dockerfile└── orchestration-report.json ← Complete execution reportTechnologies
Section titled “Technologies”| Component | Technology |
|---|---|
| Agent framework | Google ADK |
| Orchestration | SequentialAgent |
| Agent communication | A2A Protocol (Linux Foundation) |
| AI model | Gemini 2.5 Flash |
| Generated infrastructure | Docker Compose |
| Generated portal | FastAPI + Jinja2 + HTMX + TailwindCSS |
| Generated monitoring | Prometheus + Grafana |
| Generated CI/CD | Bash scripts + Jenkinsfile |
When to use this system
Section titled “When to use this system”- You want to see Google ADK + SequentialAgent in a real project with working code
- You need a solid starting point for an IDP in your organization
- You want to understand how to implement A2A Protocol with shared artifacts
- You’re learning Gemini function calling in a complex multi-agent context