# pt-23/zazencodes-season-3 architecture

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

- Interactive diagram: https://gitdiagram.com/pt-23/zazencodes-season-3
- Repository: https://github.com/pt-23/zazencodes-season-3

## Overview

This repository is a season of independent video projects, not one application. The README describes each product’s user-facing purpose; the graph keeps those separate and highlights representative workflows and distinct subsystems. Source excerpts confirm selected wiring (notably the meal helper, dataset explorer, and RPG); other links use README evidence, so they describe documented capabilities rather than inspected implementation details.

Main entry points: [`src/neon-meal-helper-agent/src/client/App.tsx`](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/App.tsx) (Meal helper UI), [`src/neon-notes-app/server.js`](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-notes-app/server.js) (Notes API), [`src/skybridge-dataset-visualizer/src/server.ts`](https://github.com/pt-23/zazencodes-season-3/blob/main/src/skybridge-dataset-visualizer/src/server.ts) (Dataset tool server), [`src/neon-meal-helper-agent/src/client/pane/Pane.tsx`](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/pane/Pane.tsx) (Kitchen panes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agents["Agent Applications"]
  node_meal_ui["Meal helper UI<br/>[App.tsx]"]
  node_meal_chat["Agent chat<br/>[Chat.tsx]"]
  node_meal_workspace["Kitchen workspace<br/>[workspace.tsx]"]
  node_meal_panes["Kitchen panes<br/>[Pane.tsx]"]
  node_meal_agent["Meal agent<br/>[agent.ts]"]
  node_meal_data[("Meal data<br/>[data.ts]")]
  node_research_app["Pocket Research<br/>[page.tsx]"]
  node_research_agent["Eve research agent<br/>[agent.ts]"]
  node_research_items[("Research items<br/>[research-items.ts]")]
  node_notes_server["Notes API<br/>[server.js]"]
  node_notes_db[("Notes database<br/>[server.js]")]
  node_notes_files[("Attachment storage<br/>[server.js]")]
end

subgraph group_interactive["Interactive Products"]
  node_kanban_app["Kanban web app<br/>[App.tsx]"]
  node_kanban_board["Board interface<br/>[Board.tsx]"]
  node_kanban_api["Kanban API<br/>[index.ts]"]
  node_kanban_db[("Board database<br/>[db.ts]")]
  node_rpg_ui["RPG interface<br/>[App.tsx]"]
  node_rpg_game["Game scenes<br/>[main.ts]"]
  node_rpg_ws["WebSocket client<br/>[client.ts]"]
  node_rpg_store["Game state<br/>[store.ts]"]
  node_rpg_sessions["Agent sessions<br/>[manager.ts]"]
  node_rpg_github["GitHub issues and PRs<br/>[gh.ts]"]
end

subgraph group_tools["Developer Tools"]
  node_dataset_server["Dataset tool server<br/>[server.ts]"]
  node_dataset_data["Dataset loading<br/>[datasets.ts]"]
  node_dataset_view["Interactive explorer<br/>[explorer.tsx]"]
  node_factory["Software factory"]
end

subgraph group_demos["Models And Skills"]
end

node_meal_user(("Meal helper user"))
node_research_user(("Researcher"))
node_notes_user(("Notes user"))
node_kanban_user(("Board user"))
node_rpg_player(("RPG player"))
node_dataset_user(("MCP user"))
node_factory_user(("Feature requester"))
node_bookkeeper_user(("Bookkeeping user"))

node_meal_user -->|"uses"| node_meal_ui
node_meal_ui -->|"renders"| node_meal_chat
node_meal_ui -->|"renders"| node_meal_panes
node_meal_ui -->|"provides context"| node_meal_workspace
node_meal_panes -->|"uses state"| node_meal_workspace
node_meal_user -->|"plans meals"| node_meal_agent
node_research_user -->|"asks questions"| node_research_app
node_research_app -->|"sends chat"| node_research_agent
node_research_agent -->|"keeps durable items"| node_research_items
node_notes_user -->|"manages notes"| node_notes_server
node_notes_server -->|"reads and writes"| node_notes_db
node_notes_server -->|"stores attachments"| node_notes_files
node_kanban_user -->|"manages board"| node_kanban_app
node_kanban_app -->|"routes to"| node_kanban_board
node_kanban_user -->|"uses CLI"| node_kanban_api
node_kanban_api -.->|"persists board data"| node_kanban_db
node_rpg_player -->|"plays"| node_rpg_ui
node_rpg_ui -->|"starts game"| node_rpg_game
node_rpg_game -->|"exchanges events"| node_rpg_ws
node_rpg_ws -->|"updates state"| node_rpg_store
node_rpg_sessions -->|"engages issues"| node_rpg_github
node_dataset_user -->|"opens tool"| node_dataset_server
node_dataset_server -->|"loads rows"| node_dataset_data
node_dataset_server -->|"returns explorer data"| node_dataset_view
node_factory_user -->|"requests feature"| node_factory
node_bookkeeper_user -.->|"uploads receipts"| node_meal_user

click node_meal_ui "https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/App.tsx"
click node_meal_chat "https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/Chat.tsx"
click node_meal_workspace "https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/workspace.tsx"
click node_meal_panes "https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/pane/Pane.tsx"
click node_meal_agent "https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/server/agent.ts"
click node_meal_data "https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/server/data.ts"
click node_research_app "https://github.com/pt-23/zazencodes-season-3/blob/main/src/eve-pocket-research/app/page.tsx"
click node_research_agent "https://github.com/pt-23/zazencodes-season-3/blob/main/src/eve-pocket-research/agent/agent.ts"
click node_research_items "https://github.com/pt-23/zazencodes-season-3/blob/main/src/eve-pocket-research/agent/lib/research-items.ts"
click node_notes_server "https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-notes-app/server.js"
click node_notes_db "https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-notes-app/server.js"
click node_notes_files "https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-notes-app/server.js"
click node_kanban_app "https://github.com/pt-23/zazencodes-season-3/blob/main/src/claude-code-devtool-kanban-board/client/src/App.tsx"
click node_kanban_board "https://github.com/pt-23/zazencodes-season-3/blob/main/src/claude-code-devtool-kanban-board/client/src/components/Board.tsx"
click node_kanban_api "https://github.com/pt-23/zazencodes-season-3/blob/main/src/claude-code-devtool-kanban-board/server/src/index.ts"
click node_kanban_db "https://github.com/pt-23/zazencodes-season-3/blob/main/src/claude-code-devtool-kanban-board/server/src/db.ts"
click node_rpg_ui "https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/client/src/App.tsx"
click node_rpg_game "https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/client/src/game/main.ts"
click node_rpg_ws "https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/client/src/ws/client.ts"
click node_rpg_store "https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/client/src/store.ts"
click node_rpg_sessions "https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/server/src/session/manager.ts"
click node_rpg_github "https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/server/src/github/gh.ts"
click node_dataset_server "https://github.com/pt-23/zazencodes-season-3/blob/main/src/skybridge-dataset-visualizer/src/server.ts"
click node_dataset_data "https://github.com/pt-23/zazencodes-season-3/blob/main/src/skybridge-dataset-visualizer/src/datasets.ts"
click node_dataset_view "https://github.com/pt-23/zazencodes-season-3/blob/main/src/skybridge-dataset-visualizer/src/views/explorer.tsx"
click node_factory "https://github.com/pt-23/zazencodes-season-3/tree/main/src/software-factory-claude-code"

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_meal_ui,node_meal_chat,node_meal_workspace,node_meal_panes,node_meal_agent,node_meal_data,node_research_app,node_research_agent,node_research_items,node_notes_server,node_notes_db,node_notes_files,node_meal_user,node_notes_user,node_kanban_user,node_dataset_user,node_bookkeeper_user toneBlue
class node_kanban_app,node_kanban_board,node_kanban_api,node_kanban_db,node_rpg_ui,node_rpg_game,node_rpg_ws,node_rpg_store,node_rpg_sessions,node_rpg_github toneAmber
class node_dataset_server,node_dataset_data,node_dataset_view,node_factory,node_factory_user toneMint
class node_research_user,node_rpg_player toneIndigo
```

## Components

### Agent Applications

- [Meal helper UI](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/App.tsx): `src/neon-meal-helper-agent/src/client/App.tsx`
- [Agent chat](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/Chat.tsx): `src/neon-meal-helper-agent/src/client/Chat.tsx`
- [Kitchen workspace](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/workspace.tsx): `src/neon-meal-helper-agent/src/client/workspace.tsx`
- [Kitchen panes](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/client/pane/Pane.tsx): `src/neon-meal-helper-agent/src/client/pane/Pane.tsx`
- [Meal agent](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/server/agent.ts): `src/neon-meal-helper-agent/src/server/agent.ts`
- [Meal data](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-meal-helper-agent/src/server/data.ts): `src/neon-meal-helper-agent/src/server/data.ts`
- [Pocket Research](https://github.com/pt-23/zazencodes-season-3/blob/main/src/eve-pocket-research/app/page.tsx): `src/eve-pocket-research/app/page.tsx`
- [Eve research agent](https://github.com/pt-23/zazencodes-season-3/blob/main/src/eve-pocket-research/agent/agent.ts): `src/eve-pocket-research/agent/agent.ts`
- [Research items](https://github.com/pt-23/zazencodes-season-3/blob/main/src/eve-pocket-research/agent/lib/research-items.ts): `src/eve-pocket-research/agent/lib/research-items.ts`
- [Notes API](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-notes-app/server.js): `src/neon-notes-app/server.js`
- [Notes database](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-notes-app/server.js): `src/neon-notes-app/server.js`
- [Attachment storage](https://github.com/pt-23/zazencodes-season-3/blob/main/src/neon-notes-app/server.js): `src/neon-notes-app/server.js`

### Interactive Products

- [Kanban web app](https://github.com/pt-23/zazencodes-season-3/blob/main/src/claude-code-devtool-kanban-board/client/src/App.tsx): `src/claude-code-devtool-kanban-board/client/src/App.tsx`
- [Board interface](https://github.com/pt-23/zazencodes-season-3/blob/main/src/claude-code-devtool-kanban-board/client/src/components/Board.tsx): `src/claude-code-devtool-kanban-board/client/src/components/Board.tsx`
- [Kanban API](https://github.com/pt-23/zazencodes-season-3/blob/main/src/claude-code-devtool-kanban-board/server/src/index.ts): `src/claude-code-devtool-kanban-board/server/src/index.ts`
- [Board database](https://github.com/pt-23/zazencodes-season-3/blob/main/src/claude-code-devtool-kanban-board/server/src/db.ts): `src/claude-code-devtool-kanban-board/server/src/db.ts`
- [RPG interface](https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/client/src/App.tsx): `src/minimax-dev-rpg/client/src/App.tsx`
- [Game scenes](https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/client/src/game/main.ts): `src/minimax-dev-rpg/client/src/game/main.ts`
- [WebSocket client](https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/client/src/ws/client.ts): `src/minimax-dev-rpg/client/src/ws/client.ts`
- [Game state](https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/client/src/store.ts): `src/minimax-dev-rpg/client/src/store.ts`
- [Agent sessions](https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/server/src/session/manager.ts): `src/minimax-dev-rpg/server/src/session/manager.ts`
- [GitHub issues and PRs](https://github.com/pt-23/zazencodes-season-3/blob/main/src/minimax-dev-rpg/server/src/github/gh.ts): `src/minimax-dev-rpg/server/src/github/gh.ts`

### Developer Tools

- [Dataset tool server](https://github.com/pt-23/zazencodes-season-3/blob/main/src/skybridge-dataset-visualizer/src/server.ts): `src/skybridge-dataset-visualizer/src/server.ts`
- [Dataset loading](https://github.com/pt-23/zazencodes-season-3/blob/main/src/skybridge-dataset-visualizer/src/datasets.ts): `src/skybridge-dataset-visualizer/src/datasets.ts`
- [Interactive explorer](https://github.com/pt-23/zazencodes-season-3/blob/main/src/skybridge-dataset-visualizer/src/views/explorer.tsx): `src/skybridge-dataset-visualizer/src/views/explorer.tsx`
- [Software factory](https://github.com/pt-23/zazencodes-season-3/tree/main/src/software-factory-claude-code): `src/software-factory-claude-code`

### Other components

- **Meal helper user**
- **Researcher**
- **Notes user**
- **Board user**
- **RPG player**
- **MCP user**
- **Feature requester**
- **Bookkeeping user**

## Connections

- Meal helper user → Meal helper UI: uses (evidence: `README.md`)
- Meal helper UI → Agent chat: renders (evidence: `src/neon-meal-helper-agent/src/client/App.tsx`)
- Meal helper UI → Kitchen panes: renders (evidence: `src/neon-meal-helper-agent/src/client/App.tsx`)
- Meal helper UI → Kitchen workspace: provides context (evidence: `src/neon-meal-helper-agent/src/client/App.tsx`)
- Kitchen panes → Kitchen workspace: uses state (evidence: `src/neon-meal-helper-agent/src/client/pane/Pane.tsx`)
- Meal helper user → Meal agent: plans meals (evidence: `README.md`)
- Researcher → Pocket Research: asks questions (evidence: `README.md`)
- Pocket Research → Eve research agent: sends chat (evidence: `README.md`)
- Eve research agent → Research items: keeps durable items (evidence: `README.md`)
- Notes user → Notes API: manages notes (evidence: `README.md`)
- Notes API → Notes database: reads and writes (evidence: `src/neon-notes-app/server.js`)
- Notes API → Attachment storage: stores attachments (evidence: `src/neon-notes-app/server.js`)
- Board user → Kanban web app: manages board (evidence: `README.md`)
- Kanban web app → Board interface: routes to (evidence: `src/claude-code-devtool-kanban-board/client/src/App.tsx`)
- Board user → Kanban API: uses CLI (evidence: `README.md`)
- Kanban API → Board database: persists board data
- RPG player → RPG interface: plays (evidence: `README.md`)
- RPG interface → Game scenes: starts game (evidence: `src/minimax-dev-rpg/client/src/App.tsx`)
- Game scenes → WebSocket client: exchanges events (evidence: `src/minimax-dev-rpg/client/src/game/scenes/WorldScene.ts`)
- WebSocket client → Game state: updates state (evidence: `src/minimax-dev-rpg/client/src/ws/client.ts`)
- Agent sessions → GitHub issues and PRs: engages issues (evidence: `README.md`)
- MCP user → Dataset tool server: opens tool (evidence: `src/skybridge-dataset-visualizer/src/server.ts`)
- Dataset tool server → Dataset loading: loads rows (evidence: `src/skybridge-dataset-visualizer/src/server.ts`)
- Dataset tool server → Interactive explorer: returns explorer data (evidence: `README.md`)
- Feature requester → Software factory: requests feature (evidence: `README.md`)
- Bookkeeping user → Meal helper user: uploads receipts
