# omarcevi/adk-multi-agent-intro architecture

> Architecture diagram of the GitHub repository omarcevi/adk-multi-agent-intro, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/omarcevi/adk-multi-agent-intro
- Repository: https://github.com/omarcevi/adk-multi-agent-intro

## Overview

This repository is a Google ADK teaching demo for a research assistant that evolves from a single tool-using agent to sequential, parallel, iterative, and coordinator-selected agent patterns. The main user workflow is step 5: a coordinator routes a request either to a quick-answer agent or to a web-research-and-brief pipeline. Earlier steps demonstrate date lookup and alternative brief-writing workflows. Edges reflect the shown agent declarations, state keys, and README workflow; the ADK runtime and model internals are not sampled.

Main entry points: [`step3_parallel/agent.py`](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py) (Research team), [`step5_coordinator/agent.py`](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py) (Brief pipeline), [`step4_loop/agent.py`](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py) (Critic), [`step2_sequential/agent.py`](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step2_sequential/agent.py) (Brief pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and date demo"]
  node_date_agent["Date assistant<br/>[agent.py]"]
  node_date_tool["Date function<br/>[agent.py]"]
end

subgraph group_sequential["Sequential research"]
  node_seq_pipeline["Brief pipeline<br/>[agent.py]"]
  node_seq_researcher["Researcher<br/>[agent.py]"]
  node_seq_writer["Brief writer<br/>[agent.py]"]
end

subgraph group_parallel["Parallel research"]
  node_par_pipeline["Brief pipeline<br/>[agent.py]"]
  node_research_team["Research team<br/>[agent.py]"]
  node_background["Background researcher<br/>[agent.py]"]
  node_current_state["Current-state researcher<br/>[agent.py]"]
  node_future_outlook["Future-outlook researcher<br/>[agent.py]"]
  node_par_writer["Brief writer<br/>[agent.py]"]
end

subgraph group_review["Draft review"]
  node_review_pipeline["Brief pipeline<br/>[agent.py]"]
  node_first_writer["First-draft writer<br/>[agent.py]"]
  node_improve_loop["Improvement loop<br/>[agent.py]"]
  node_critic["Critic<br/>[agent.py]"]
  node_reviser["Reviser<br/>[agent.py]"]
end

subgraph group_coordinator["Coordinator workflow"]
  node_front_desk["Front desk<br/>[agent.py]"]
  node_quick_answer["Quick answer<br/>[agent.py]"]
  node_brief_pipeline["Brief pipeline<br/>[agent.py]"]
  node_web_researcher["Web researcher<br/>[agent.py]"]
  node_draft_writer["First-draft writer<br/>[agent.py]"]
  node_coord_loop["Improvement loop<br/>[agent.py]"]
  node_coord_critic["Critic<br/>[agent.py]"]
  node_coord_reviser["Reviser<br/>[agent.py]"]
end

node_user(("User"))
node_adk_web["ADK Web"]
node_google_search["Google Search"]

node_user -->|"submits prompt"| node_adk_web
node_adk_web -->|"selects demo"| node_date_agent
node_adk_web -->|"selects demo"| node_seq_pipeline
node_adk_web -->|"selects demo"| node_par_pipeline
node_adk_web -->|"selects demo"| node_review_pipeline
node_adk_web -->|"selects demo"| node_front_desk
node_date_agent -->|"calls"| node_date_tool
node_seq_pipeline -->|"runs first"| node_seq_researcher
node_seq_pipeline -->|"runs second"| node_seq_writer
node_seq_researcher -->|"shares research"| node_seq_writer
node_par_pipeline -->|"runs first"| node_research_team
node_par_pipeline -->|"runs after"| node_par_writer
node_research_team -->|"runs in parallel"| node_background
node_research_team -->|"runs in parallel"| node_current_state
node_research_team -->|"runs in parallel"| node_future_outlook
node_background -->|"shares notes"| node_par_writer
node_current_state -->|"shares notes"| node_par_writer
node_future_outlook -->|"shares notes"| node_par_writer
node_review_pipeline -->|"runs first"| node_first_writer
node_review_pipeline -->|"runs after"| node_improve_loop
node_improve_loop -->|"runs in loop"| node_critic
node_improve_loop -->|"runs in loop"| node_reviser
node_first_writer -->|"shares draft"| node_critic
node_critic -->|"shares feedback"| node_reviser
node_reviser -->|"updates draft"| node_critic
node_front_desk -->|"routes request"| node_quick_answer
node_front_desk -->|"routes request"| node_brief_pipeline
node_brief_pipeline -->|"runs first"| node_web_researcher
node_brief_pipeline -->|"runs second"| node_draft_writer
node_brief_pipeline -->|"runs third"| node_coord_loop
node_web_researcher -->|"searches web"| node_google_search
node_web_researcher -->|"shares research"| node_draft_writer
node_coord_loop -->|"runs in loop"| node_coord_critic
node_coord_loop -->|"runs in loop"| node_coord_reviser
node_draft_writer -->|"shares draft"| node_coord_critic
node_coord_critic -->|"shares feedback"| node_coord_reviser
node_coord_reviser -->|"updates draft"| node_coord_critic

click node_date_agent "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step1_single_agent/agent.py"
click node_date_tool "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step1_single_agent/agent.py"
click node_seq_pipeline "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step2_sequential/agent.py"
click node_seq_researcher "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step2_sequential/agent.py"
click node_seq_writer "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step2_sequential/agent.py"
click node_par_pipeline "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py"
click node_research_team "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py"
click node_background "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py"
click node_current_state "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py"
click node_future_outlook "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py"
click node_par_writer "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py"
click node_review_pipeline "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py"
click node_first_writer "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py"
click node_improve_loop "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py"
click node_critic "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py"
click node_reviser "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py"
click node_front_desk "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py"
click node_quick_answer "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py"
click node_brief_pipeline "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py"
click node_web_researcher "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py"
click node_draft_writer "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py"
click node_coord_loop "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py"
click node_coord_critic "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py"
click node_coord_reviser "https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_date_agent,node_date_tool,node_user toneBlue
class node_seq_pipeline,node_seq_researcher,node_seq_writer toneAmber
class node_par_pipeline,node_research_team,node_background,node_current_state,node_future_outlook,node_par_writer toneMint
class node_review_pipeline,node_first_writer,node_improve_loop,node_critic,node_reviser toneRose
class node_front_desk,node_quick_answer,node_brief_pipeline,node_web_researcher,node_draft_writer,node_coord_loop,node_coord_critic,node_coord_reviser,node_adk_web,node_google_search toneIndigo
```

## Components

### Entry and date demo

- [Date assistant](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step1_single_agent/agent.py): `step1_single_agent/agent.py`
- [Date function](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step1_single_agent/agent.py): `step1_single_agent/agent.py`

### Sequential research

- [Brief pipeline](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step2_sequential/agent.py): `step2_sequential/agent.py`
- [Researcher](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step2_sequential/agent.py): `step2_sequential/agent.py`
- [Brief writer](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step2_sequential/agent.py): `step2_sequential/agent.py`

### Parallel research

- [Brief pipeline](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py): `step3_parallel/agent.py`
- [Research team](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py): `step3_parallel/agent.py`
- [Background researcher](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py): `step3_parallel/agent.py`
- [Current-state researcher](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py): `step3_parallel/agent.py`
- [Future-outlook researcher](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py): `step3_parallel/agent.py`
- [Brief writer](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step3_parallel/agent.py): `step3_parallel/agent.py`

### Draft review

- [Brief pipeline](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py): `step4_loop/agent.py`
- [First-draft writer](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py): `step4_loop/agent.py`
- [Improvement loop](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py): `step4_loop/agent.py`
- [Critic](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py): `step4_loop/agent.py`
- [Reviser](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step4_loop/agent.py): `step4_loop/agent.py`

### Coordinator workflow

- [Front desk](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py): `step5_coordinator/agent.py`
- [Quick answer](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py): `step5_coordinator/agent.py`
- [Brief pipeline](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py): `step5_coordinator/agent.py`
- [Web researcher](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py): `step5_coordinator/agent.py`
- [First-draft writer](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py): `step5_coordinator/agent.py`
- [Improvement loop](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py): `step5_coordinator/agent.py`
- [Critic](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py): `step5_coordinator/agent.py`
- [Reviser](https://github.com/omarcevi/adk-multi-agent-intro/blob/main/step5_coordinator/agent.py): `step5_coordinator/agent.py`

### Other components

- **User**
- **ADK Web**
- **Google Search**

## Connections

- User → ADK Web: submits prompt (evidence: `README.md`)
- ADK Web → Date assistant: selects demo (evidence: `README.md`)
- ADK Web → Brief pipeline: selects demo (evidence: `README.md`)
- ADK Web → Brief pipeline: selects demo (evidence: `README.md`)
- ADK Web → Brief pipeline: selects demo (evidence: `README.md`)
- ADK Web → Front desk: selects demo (evidence: `README.md`)
- Date assistant → Date function: calls (evidence: `step1_single_agent/agent.py`)
- Brief pipeline → Researcher: runs first (evidence: `step2_sequential/agent.py`)
- Brief pipeline → Brief writer: runs second (evidence: `step2_sequential/agent.py`)
- Researcher → Brief writer: shares research (evidence: `step2_sequential/agent.py`)
- Brief pipeline → Research team: runs first (evidence: `step3_parallel/agent.py`)
- Brief pipeline → Brief writer: runs after (evidence: `step3_parallel/agent.py`)
- Research team → Background researcher: runs in parallel (evidence: `step3_parallel/agent.py`)
- Research team → Current-state researcher: runs in parallel (evidence: `step3_parallel/agent.py`)
- Research team → Future-outlook researcher: runs in parallel (evidence: `step3_parallel/agent.py`)
- Background researcher → Brief writer: shares notes (evidence: `step3_parallel/agent.py`)
- Current-state researcher → Brief writer: shares notes (evidence: `step3_parallel/agent.py`)
- Future-outlook researcher → Brief writer: shares notes (evidence: `step3_parallel/agent.py`)
- Brief pipeline → First-draft writer: runs first (evidence: `step4_loop/agent.py`)
- Brief pipeline → Improvement loop: runs after (evidence: `step4_loop/agent.py`)
- Improvement loop → Critic: runs in loop (evidence: `step4_loop/agent.py`)
- Improvement loop → Reviser: runs in loop (evidence: `step4_loop/agent.py`)
- First-draft writer → Critic: shares draft (evidence: `step4_loop/agent.py`)
- Critic → Reviser: shares feedback (evidence: `step4_loop/agent.py`)
- Reviser → Critic: updates draft (evidence: `step4_loop/agent.py`)
- Front desk → Quick answer: routes request (evidence: `step5_coordinator/agent.py`)
- Front desk → Brief pipeline: routes request (evidence: `step5_coordinator/agent.py`)
- Brief pipeline → Web researcher: runs first (evidence: `step5_coordinator/agent.py`)
- Brief pipeline → First-draft writer: runs second (evidence: `step5_coordinator/agent.py`)
- Brief pipeline → Improvement loop: runs third (evidence: `step5_coordinator/agent.py`)
- Web researcher → Google Search: searches web (evidence: `step5_coordinator/agent.py`)
- Web researcher → First-draft writer: shares research (evidence: `step5_coordinator/agent.py`)
- Improvement loop → Critic: runs in loop (evidence: `step5_coordinator/agent.py`)
- Improvement loop → Reviser: runs in loop (evidence: `step5_coordinator/agent.py`)
- First-draft writer → Critic: shares draft (evidence: `step5_coordinator/agent.py`)
- Critic → Reviser: shares feedback (evidence: `step5_coordinator/agent.py`)
- Reviser → Critic: updates draft (evidence: `step5_coordinator/agent.py`)
