# tzolov/voxxeddays2026-demo architecture

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

- Interactive diagram: https://gitdiagram.com/tzolov/voxxeddays2026-demo
- Repository: https://github.com/tzolov/voxxeddays2026-demo

## Overview

This repository is a collection of independent Spring AI examples, rather than one application. The clearest end-to-end workflow is the travel-planner skill: a trip plan is generated using saved preferences and can be persisted in the travel database. Other examples demonstrate chat setup, skills, tools, memory, subagents, and agent protocols. Several applications are visible only in the tree, so those appear as capability nodes without speculative connections; the map reflects the sampled sources, not a verified inventory of every example’s runtime behavior.

Main entry points: [`15-agents-ask-user-question/src/main/java/org/springaicommunity/agent/Application.java`](https://github.com/tzolov/voxxeddays2026-demo/blob/main/15-agents-ask-user-question/src/main/java/org/springaicommunity/agent/Application.java) (Question assistant), [`16-agents-subagent/src/main/java/org/springaicommunity/agent/Application.java`](https://github.com/tzolov/voxxeddays2026-demo/blob/main/16-agents-subagent/src/main/java/org/springaicommunity/agent/Application.java) (Subagent assistant), [`14-agents-todo-write/src/main/java/org/springaicommunity/agent/Application.java`](https://github.com/tzolov/voxxeddays2026-demo/blob/main/14-agents-todo-write/src/main/java/org/springaicommunity/agent/Application.java) (Todo assistant), [`13-agents-skills/src/main/java/org/springaicommunity/skills/Application.java`](https://github.com/tzolov/voxxeddays2026-demo/blob/main/13-agents-skills/src/main/java/org/springaicommunity/skills/Application.java) (Skills demo)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agents["Agent examples"]
  node_subagent_app["Subagent assistant<br/>[Application.java]"]
  node_todo_app["Todo assistant<br/>[Application.java]"]
  node_question_app["Question assistant<br/>[Application.java]"]
  node_tools["Tool examples"]
end

subgraph group_skills["Skills and planning"]
  node_skills_app["Skills demo<br/>[Application.java]"]
  node_travel_plan["Plan generator<br/>[plan_generator.py]"]
  node_travel_db[("Travel database<br/>[travel_db.py]")]
  node_tutor_transcript["Transcript extractor"]
end

subgraph group_chat["Chat capabilities"]
  node_chat_memory["Chat memory demos"]
  node_system_instructions["System instructions"]
  node_structured_output["Structured output"]
  node_rag["RAG examples"]
  node_modular_rag["Modular RAG"]
  node_guardrails["Guardrail demos"]
  node_ontology["Ontology checker"]
end

subgraph group_protocols["Agent protocols"]
  node_mcp_client["MCP client"]
  node_mcp_server["MCP server"]
  node_a2a_agent["A2A agent<br/>[A2AAgent.java]"]
end

node_user(("User"))
node_llm{{"Chat model"}}
node_cli_question(("CLI user"))

node_user -->|"enters prompt"| node_subagent_app
node_subagent_app -->|"calls chat"| node_llm
node_user -->|"enters prompt"| node_todo_app
node_todo_app -->|"calls chat"| node_llm
node_user -->|"enters prompt"| node_question_app
node_question_app -->|"calls chat"| node_llm
node_cli_question -->|"answers questions"| node_question_app
node_user -->|"requests assistance"| node_skills_app
node_skills_app -->|"calls chat"| node_llm
node_travel_plan -->|"reads preferences"| node_travel_db
node_travel_db -->|"provides preferences"| node_travel_plan

click node_subagent_app "https://github.com/tzolov/voxxeddays2026-demo/blob/main/16-agents-subagent/src/main/java/org/springaicommunity/agent/Application.java"
click node_todo_app "https://github.com/tzolov/voxxeddays2026-demo/blob/main/14-agents-todo-write/src/main/java/org/springaicommunity/agent/Application.java"
click node_question_app "https://github.com/tzolov/voxxeddays2026-demo/blob/main/15-agents-ask-user-question/src/main/java/org/springaicommunity/agent/Application.java"
click node_skills_app "https://github.com/tzolov/voxxeddays2026-demo/blob/main/13-agents-skills/src/main/java/org/springaicommunity/skills/Application.java"
click node_travel_plan "https://github.com/tzolov/voxxeddays2026-demo/blob/main/18-a2a/subagent-a2a-demo/src/main/resources/skills/travel-planner/scripts/plan_generator.py"
click node_travel_db "https://github.com/tzolov/voxxeddays2026-demo/blob/main/18-a2a/subagent-a2a-demo/src/main/resources/skills/travel-planner/scripts/travel_db.py"
click node_tutor_transcript "https://github.com/tzolov/voxxeddays2026-demo/blob/main/16-agents-subagent/src/main/resources/skills/ai-tutor/scripts/get_youtube_transcript.py"
click node_chat_memory "https://github.com/tzolov/voxxeddays2026-demo/blob/main/03-chat-memory/src/main/java/com/example/demo/DemoApplication.java"
click node_system_instructions "https://github.com/tzolov/voxxeddays2026-demo/blob/main/01-system-instructions/src/main/java/com/example/demo/DemoApplication.java"
click node_structured_output "https://github.com/tzolov/voxxeddays2026-demo/blob/main/02-structured-output/src/main/java/com/example/demo/DemoApplication.java"
click node_rag "https://github.com/tzolov/voxxeddays2026-demo/blob/main/05-rag/src/main/java/com/example/demo/DemoApplication.java"
click node_modular_rag "https://github.com/tzolov/voxxeddays2026-demo/blob/main/05-1-modular-rag/src/main/java/com/example/demo/DemoApplication.java"
click node_guardrails "https://github.com/tzolov/voxxeddays2026-demo/blob/main/06-guardrails-safe-input/src/main/java/com/example/demo/DemoApplication.java"
click node_ontology "https://github.com/tzolov/voxxeddays2026-demo/blob/main/21-guardrails-ontology-checker/src/main/java/com/example/demo/OntologyValidationAdvisor.java"
click node_tools "https://github.com/tzolov/voxxeddays2026-demo/blob/main/08-tools/src/main/java/com/example/demo/ToolDemoApplication.java"
click node_mcp_client "https://github.com/tzolov/voxxeddays2026-demo/blob/main/17-mcp/mcp-client/src/main/java/org/springframework/ai/mcp/samples/client/McpClientApplication.java"
click node_mcp_server "https://github.com/tzolov/voxxeddays2026-demo/blob/main/17-mcp/mcp-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java"
click node_a2a_agent "https://github.com/tzolov/voxxeddays2026-demo/blob/main/18-a2a/airbnb-agent/src/main/java/com/example/demo/a2a/A2AAgent.java"

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_subagent_app,node_todo_app,node_question_app,node_tools,node_user,node_cli_question toneBlue
class node_skills_app,node_travel_plan,node_travel_db,node_tutor_transcript toneAmber
class node_chat_memory,node_system_instructions,node_structured_output,node_rag,node_modular_rag,node_guardrails,node_ontology toneMint
class node_mcp_client,node_mcp_server,node_a2a_agent toneRose
class node_llm toneIndigo
```

## Components

### Agent examples

- [Subagent assistant](https://github.com/tzolov/voxxeddays2026-demo/blob/main/16-agents-subagent/src/main/java/org/springaicommunity/agent/Application.java): `16-agents-subagent/src/main/java/org/springaicommunity/agent/Application.java`
- [Todo assistant](https://github.com/tzolov/voxxeddays2026-demo/blob/main/14-agents-todo-write/src/main/java/org/springaicommunity/agent/Application.java): `14-agents-todo-write/src/main/java/org/springaicommunity/agent/Application.java`
- [Question assistant](https://github.com/tzolov/voxxeddays2026-demo/blob/main/15-agents-ask-user-question/src/main/java/org/springaicommunity/agent/Application.java): `15-agents-ask-user-question/src/main/java/org/springaicommunity/agent/Application.java`
- [Tool examples](https://github.com/tzolov/voxxeddays2026-demo/blob/main/08-tools/src/main/java/com/example/demo/ToolDemoApplication.java): `08-tools/src/main/java/com/example/demo/ToolDemoApplication.java`

### Skills and planning

- [Skills demo](https://github.com/tzolov/voxxeddays2026-demo/blob/main/13-agents-skills/src/main/java/org/springaicommunity/skills/Application.java): `13-agents-skills/src/main/java/org/springaicommunity/skills/Application.java`
- [Plan generator](https://github.com/tzolov/voxxeddays2026-demo/blob/main/18-a2a/subagent-a2a-demo/src/main/resources/skills/travel-planner/scripts/plan_generator.py): `18-a2a/subagent-a2a-demo/src/main/resources/skills/travel-planner/scripts/plan_generator.py`
- [Travel database](https://github.com/tzolov/voxxeddays2026-demo/blob/main/18-a2a/subagent-a2a-demo/src/main/resources/skills/travel-planner/scripts/travel_db.py): `18-a2a/subagent-a2a-demo/src/main/resources/skills/travel-planner/scripts/travel_db.py`
- [Transcript extractor](https://github.com/tzolov/voxxeddays2026-demo/blob/main/16-agents-subagent/src/main/resources/skills/ai-tutor/scripts/get_youtube_transcript.py): `16-agents-subagent/src/main/resources/skills/ai-tutor/scripts/get_youtube_transcript.py`

### Chat capabilities

- [Chat memory demos](https://github.com/tzolov/voxxeddays2026-demo/blob/main/03-chat-memory/src/main/java/com/example/demo/DemoApplication.java): `03-chat-memory/src/main/java/com/example/demo/DemoApplication.java`
- [System instructions](https://github.com/tzolov/voxxeddays2026-demo/blob/main/01-system-instructions/src/main/java/com/example/demo/DemoApplication.java): `01-system-instructions/src/main/java/com/example/demo/DemoApplication.java`
- [Structured output](https://github.com/tzolov/voxxeddays2026-demo/blob/main/02-structured-output/src/main/java/com/example/demo/DemoApplication.java): `02-structured-output/src/main/java/com/example/demo/DemoApplication.java`
- [RAG examples](https://github.com/tzolov/voxxeddays2026-demo/blob/main/05-rag/src/main/java/com/example/demo/DemoApplication.java): `05-rag/src/main/java/com/example/demo/DemoApplication.java`
- [Modular RAG](https://github.com/tzolov/voxxeddays2026-demo/blob/main/05-1-modular-rag/src/main/java/com/example/demo/DemoApplication.java): `05-1-modular-rag/src/main/java/com/example/demo/DemoApplication.java`
- [Guardrail demos](https://github.com/tzolov/voxxeddays2026-demo/blob/main/06-guardrails-safe-input/src/main/java/com/example/demo/DemoApplication.java): `06-guardrails-safe-input/src/main/java/com/example/demo/DemoApplication.java`
- [Ontology checker](https://github.com/tzolov/voxxeddays2026-demo/blob/main/21-guardrails-ontology-checker/src/main/java/com/example/demo/OntologyValidationAdvisor.java): `21-guardrails-ontology-checker/src/main/java/com/example/demo/OntologyValidationAdvisor.java`

### Agent protocols

- [MCP client](https://github.com/tzolov/voxxeddays2026-demo/blob/main/17-mcp/mcp-client/src/main/java/org/springframework/ai/mcp/samples/client/McpClientApplication.java): `17-mcp/mcp-client/src/main/java/org/springframework/ai/mcp/samples/client/McpClientApplication.java`
- [MCP server](https://github.com/tzolov/voxxeddays2026-demo/blob/main/17-mcp/mcp-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java): `17-mcp/mcp-server/src/main/java/org/springframework/ai/mcp/sample/server/McpServerApplication.java`
- [A2A agent](https://github.com/tzolov/voxxeddays2026-demo/blob/main/18-a2a/airbnb-agent/src/main/java/com/example/demo/a2a/A2AAgent.java): `18-a2a/airbnb-agent/src/main/java/com/example/demo/a2a/A2AAgent.java`

### Other components

- **User**
- **Chat model**
- **CLI user**

## Connections

- User → Subagent assistant: enters prompt (evidence: `16-agents-subagent/src/main/java/org/springaicommunity/agent/Application.java`)
- Subagent assistant → Chat model: calls chat (evidence: `16-agents-subagent/src/main/java/org/springaicommunity/agent/Application.java`)
- User → Todo assistant: enters prompt (evidence: `14-agents-todo-write/src/main/java/org/springaicommunity/agent/Application.java`)
- Todo assistant → Chat model: calls chat (evidence: `14-agents-todo-write/src/main/java/org/springaicommunity/agent/Application.java`)
- User → Question assistant: enters prompt (evidence: `15-agents-ask-user-question/src/main/java/org/springaicommunity/agent/Application.java`)
- Question assistant → Chat model: calls chat (evidence: `15-agents-ask-user-question/src/main/java/org/springaicommunity/agent/Application.java`)
- CLI user → Question assistant: answers questions (evidence: `15-agents-ask-user-question/src/main/java/org/springaicommunity/agent/Application.java`)
- User → Skills demo: requests assistance (evidence: `13-agents-skills/src/main/java/org/springaicommunity/skills/Application.java`)
- Skills demo → Chat model: calls chat (evidence: `13-agents-skills/src/main/java/org/springaicommunity/skills/Application.java`)
- Plan generator → Travel database: reads preferences (evidence: `18-a2a/subagent-a2a-demo/src/main/resources/skills/travel-planner/scripts/plan_generator.py`)
- Travel database → Plan generator: provides preferences (evidence: `18-a2a/subagent-a2a-demo/src/main/resources/skills/travel-planner/scripts/plan_generator.py`)
