# ai-playbooks/videoexpress-stickman-story-agent architecture

> Architecture diagram of the GitHub repository ai-playbooks/videoexpress-stickman-story-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ai-playbooks/videoexpress-stickman-story-agent
- Repository: https://github.com/ai-playbooks/videoexpress-stickman-story-agent

## Overview

This repository defines a browser-operated VideoExpress agent for producing narrated 2D stories. The main workflow runs from a user’s topic and preferences through character and scene planning, image and narrated-video generation, review, timeline assembly, and export. The README also documents continuity controls, voice and account constraints, and a concurrent-production mode. No source excerpts were provided, so the graph reflects documented relationships only; the workflow prompt’s implementation details are unverified.

Main entry points: [`SYSTEM_PROMPT.md`](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/SYSTEM_PROMPT.md) (Browser agent), [`README.md`](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md) (Video generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Story planning"]
  node_agent["Browser agent<br/>[SYSTEM_PROMPT.md]"]
  node_intake["Request and preferences<br/>[README.md]"]
  node_character["Character master<br/>[README.md]"]
  node_storyboard["Action storyboard<br/>[README.md]"]
  node_continuity["Scene continuity<br/>[README.md]"]
end

subgraph group_production["Media production"]
  node_sceneimages["Scene images<br/>[README.md]"]
  node_narration["Integrated narration<br/>[README.md]"]
  node_videogeneration["Video generation<br/>[README.md]"]
  node_queue["Concurrent jobs<br/>[README.md]"]
end

subgraph group_delivery["Review and delivery"]
  node_review["Quality review<br/>[README.md]"]
  node_timeline["Timeline assembly<br/>[README.md]"]
  node_export["Saved export<br/>[README.md]"]
end

node_user(("User"))
node_videoexpress["VideoExpress"]

node_user -->|"provides request"| node_agent
node_agent -->|"collects preferences"| node_intake
node_agent -->|"operates"| node_videoexpress
node_agent -->|"creates first"| node_character
node_agent -->|"plans actions"| node_storyboard
node_storyboard -->|"guides handoffs"| node_continuity
node_agent -->|"generates scenes"| node_sceneimages
node_character -->|"anchors identity"| node_sceneimages
node_continuity -->|"guides prompts"| node_sceneimages
node_agent -->|"creates audio"| node_narration
node_agent -->|"submits clips"| node_videogeneration
node_narration -->|"integrates audio"| node_videogeneration
node_videogeneration -->|"runs concurrently"| node_queue
node_queue -->|"provides completed clips"| node_review
node_review -->|"selects usable clips"| node_timeline
node_agent -->|"assembles scenes"| node_timeline
node_timeline -->|"saves and exports"| node_export
node_agent -->|"checks quality"| node_review

click node_agent "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/SYSTEM_PROMPT.md"
click node_intake "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_character "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_storyboard "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_continuity "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_sceneimages "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_narration "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_videogeneration "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_queue "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_review "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_timeline "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"
click node_export "https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md"

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_agent,node_intake,node_character,node_storyboard,node_continuity,node_user toneBlue
class node_sceneimages,node_narration,node_videogeneration,node_queue toneAmber
class node_review,node_timeline,node_export toneMint
class node_videoexpress toneIndigo
```

## Components

### Story planning

- [Browser agent](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/SYSTEM_PROMPT.md): `SYSTEM_PROMPT.md`
- [Request and preferences](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`
- [Character master](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`
- [Action storyboard](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`
- [Scene continuity](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`

### Media production

- [Scene images](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`
- [Integrated narration](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`
- [Video generation](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`
- [Concurrent jobs](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`

### Review and delivery

- [Quality review](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`
- [Timeline assembly](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`
- [Saved export](https://github.com/ai-playbooks/videoexpress-stickman-story-agent/blob/main/README.md): `README.md`

### Other components

- **User**
- **VideoExpress**

## Connections

- User → Browser agent: provides request (evidence: `README.md`)
- Browser agent → Request and preferences: collects preferences (evidence: `README.md`)
- Browser agent → VideoExpress: operates (evidence: `README.md`)
- Browser agent → Character master: creates first (evidence: `README.md`)
- Browser agent → Action storyboard: plans actions (evidence: `README.md`)
- Action storyboard → Scene continuity: guides handoffs (evidence: `README.md`)
- Browser agent → Scene images: generates scenes (evidence: `README.md`)
- Character master → Scene images: anchors identity (evidence: `README.md`)
- Scene continuity → Scene images: guides prompts (evidence: `README.md`)
- Browser agent → Integrated narration: creates audio (evidence: `README.md`)
- Browser agent → Video generation: submits clips (evidence: `README.md`)
- Integrated narration → Video generation: integrates audio (evidence: `README.md`)
- Video generation → Concurrent jobs: runs concurrently (evidence: `README.md`)
- Concurrent jobs → Quality review: provides completed clips (evidence: `README.md`)
- Quality review → Timeline assembly: selects usable clips (evidence: `README.md`)
- Browser agent → Timeline assembly: assembles scenes (evidence: `README.md`)
- Timeline assembly → Saved export: saves and exports (evidence: `README.md`)
- Browser agent → Quality review: checks quality (evidence: `README.md`)
