What This Is

A working multi-agent system that audits codebases for ADK/Vertex AI pattern compliance. Connects to Slack, runs on Vertex AI Agent Engine, uses the A2A protocol for agent coordination.

Architecture

  • Bob - Slack-connected orchestrator agent
  • iam-senior-adk-devops-lead - Foreman that coordinates specialist work
  • 8 specialist agents - iam-adk, iam-issue, iam-fix-plan, iam-fix-impl, iam-qa, iam-doc, iam-cleanup, iam-index

What It Does

  • Scans repositories for ADK pattern violations
  • Detects drift from Vertex AI recommended architecture
  • Constructs fix plans and generates PRs
  • Validates memory wiring, gateway separation, import patterns

Hard Mode Rules (R1-R8)

CI-enforced architectural constraints. These run on every push and block violations.

RuleWhat It Enforces
R1ADK-only. No LangChain, CrewAI, or custom frameworks.
R2Vertex AI Agent Engine runtime. No self-hosted runners.
R3Gateway separation. Cloud Run proxies only.
R4CI-only deployments. GitHub Actions with WIF.
R5Dual memory. Session + Memory Bank wiring.
R6Single docs folder. 000-docs/ with NNN-CC-ABCD naming.
R7SPIFFE ID propagation in AgentCard, logs, headers.
R8Drift detection. Blocks forbidden imports in CI.

Implemented Patterns

7 of 8 patterns from Google's multi-agent patterns guide. Reusable templates in templates/.

PatternADK PrimitiveStatus
Sequential PipelineSequentialAgentDone
Parallel Fan-OutParallelAgentDone
Quality GatesLoopAgentDone
Human-in-the-LoopCallbacksDone
Agent-to-AgentA2A ProtocolDone
Foreman-WorkerLlmAgentDone
Iterative RefinementLoopAgentDone
Routing/Delegation-Planned

Open Source

Featured in Google's Agent Starter Pack community showcase (PR #580) as a production ADK reference implementation.

Repository Stats

  • 9 agent implementations
  • 8 reusable pattern templates
  • 17 test files (unit + integration)
  • CI passes: lint, drift detection, ARV gates
  • Terraform modules for Agent Engine deployment

License

Elastic License 2.0 (ELv2). Use it, learn from it, build on it.

System Flow

sequenceDiagram
    participant Slack
    participant Gateway as Cloud Run Gateway
    participant Bob as Bob (Agent Engine)
    participant Foreman as iam-senior-adk-devops-lead
    participant Specialists as iam-* agents

    Slack->>Gateway: @Bob message
    Gateway->>Bob: POST to Agent Engine
    Bob->>Foreman: Delegate task
    Foreman->>Specialists: Coordinate work
    Specialists-->>Foreman: Results
    Foreman-->>Bob: Consolidated response
    Bob->>Gateway: Format reply
    Gateway->>Slack: Thread response

Stack

Runtime

  • Vertex AI Agent Engine
  • Cloud Run (gateway)
  • Python 3.12

Agent Framework

  • Google ADK
  • A2A Protocol
  • Gemini 2.0 Flash

Infrastructure

  • Terraform
  • GitHub Actions
  • Workload Identity Federation

Links

Repository

Documentation

References