# taosiuman/seedancer architecture

> Architecture diagram of the GitHub repository taosiuman/seedancer, 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/taosiuman/seedancer
- Repository: https://github.com/taosiuman/seedancer

## Overview

Seedancer is an agent-loaded film-directing skill: it turns a user's script or shot brief into production-ready, often bilingual video prompts rather than rendering video itself. The documented full workflow runs from project intake and script analysis through creative and asset preparation, then a 12-gate production flow and storyboard/prompt output; a single-shot request can skip pre-production. The graph also preserves documented directing systems and output modes. Relationship evidence is limited to the README and file tree; unsampled skill and reference contents were not inspected.

Main entry points: [`SKILL.md`](https://github.com/taosiuman/seedancer/blob/master/SKILL.md) (Agent Skill), [`references/qa-strict-gates.md`](https://github.com/taosiuman/seedancer/blob/master/references/qa-strict-gates.md) (Quality Gates), [`references/cinedance-video-prompt.md`](https://github.com/taosiuman/seedancer/blob/master/references/cinedance-video-prompt.md) (Prompt Construction), [`references/project-workbench.md`](https://github.com/taosiuman/seedancer/blob/master/references/project-workbench.md) (Project Intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Production Workflow"]
  node_skill["Agent Skill<br/>[SKILL.md]"]
  node_intake["Project Intake"]
  node_analysis["Script Analysis<br/>[story-analysis.md]"]
  node_baseline["Creative Baseline"]
  node_characters["Character Assets"]
  node_props["Key Props<br/>[prop-assets.md]"]
  node_gates["Quality Gates<br/>[qa-strict-gates.md]"]
end

subgraph group_directing["Directing Systems"]
  node_scene["Scene Router"]
  node_camera["Camera Design<br/>[camera-design.md]"]
  node_emotion["Camera-Emotion Sync"]
  node_performance["Performance Beats"]
  node_lighting["Lighting Rules<br/>[lighting-rules.md]"]
  node_dialogue["Dialogue Capacity"]
  node_density["Group and Density"]
end

subgraph group_output["Prompt Output"]
  node_prompt["Prompt Construction"]
  node_format["Output Format<br/>[output-format.md]"]
  node_json["JSON API Mode<br/>[json-api-mode.md]"]
  node_storyboard["Storyboard"]
end

node_user(("Filmmaker"))

node_user -->|"requests production"| node_skill
node_skill -->|"starts at"| node_intake
node_intake -->|"continues to"| node_analysis
node_analysis -->|"continues to"| node_baseline
node_baseline -->|"continues to"| node_characters
node_characters -->|"continues to"| node_props
node_props -->|"enters production"| node_gates
node_skill -->|"routes through"| node_gates
node_gates -->|"constructs prompts"| node_prompt
node_prompt -->|"produces"| node_storyboard
node_skill -->|"classifies scenes"| node_scene
node_skill -->|"applies design"| node_camera
node_skill -->|"syncs camera"| node_emotion
node_skill -->|"specifies beats"| node_performance
node_skill -->|"applies lighting"| node_lighting
node_gates -->|"checks capacity"| node_dialogue
node_gates -->|"checks density"| node_density
node_prompt -->|"conforms to"| node_format
node_prompt -->|"can emit"| node_json

click node_skill "https://github.com/taosiuman/seedancer/blob/master/SKILL.md"
click node_intake "https://github.com/taosiuman/seedancer/blob/master/references/project-workbench.md"
click node_analysis "https://github.com/taosiuman/seedancer/blob/master/references/story-analysis.md"
click node_baseline "https://github.com/taosiuman/seedancer/blob/master/references/creative-baseline.md"
click node_characters "https://github.com/taosiuman/seedancer/blob/master/references/character-assets.md"
click node_props "https://github.com/taosiuman/seedancer/blob/master/references/prop-assets.md"
click node_gates "https://github.com/taosiuman/seedancer/blob/master/references/qa-strict-gates.md"
click node_scene "https://github.com/taosiuman/seedancer/blob/master/references/scene-prototypes.md"
click node_camera "https://github.com/taosiuman/seedancer/blob/master/references/camera-design.md"
click node_emotion "https://github.com/taosiuman/seedancer/blob/master/references/camera-emotion-sync.md"
click node_performance "https://github.com/taosiuman/seedancer/blob/master/references/performance-micro-beats.md"
click node_lighting "https://github.com/taosiuman/seedancer/blob/master/references/lighting-rules.md"
click node_dialogue "https://github.com/taosiuman/seedancer/blob/master/references/dialogue-capacity.md"
click node_density "https://github.com/taosiuman/seedancer/blob/master/references/grouping-density.md"
click node_prompt "https://github.com/taosiuman/seedancer/blob/master/references/cinedance-video-prompt.md"
click node_format "https://github.com/taosiuman/seedancer/blob/master/references/output-format.md"
click node_json "https://github.com/taosiuman/seedancer/blob/master/references/json-api-mode.md"
click node_storyboard "https://github.com/taosiuman/seedancer/blob/master/references/deliverable-system.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_skill,node_intake,node_analysis,node_baseline,node_characters,node_props,node_gates toneBlue
class node_scene,node_camera,node_emotion,node_performance,node_lighting,node_dialogue,node_density toneAmber
class node_prompt,node_format,node_json,node_storyboard toneMint
class node_user toneIndigo
```

## Components

### Production Workflow

- [Agent Skill](https://github.com/taosiuman/seedancer/blob/master/SKILL.md): `SKILL.md`
- [Project Intake](https://github.com/taosiuman/seedancer/blob/master/references/project-workbench.md): `references/project-workbench.md`
- [Script Analysis](https://github.com/taosiuman/seedancer/blob/master/references/story-analysis.md): `references/story-analysis.md`
- [Creative Baseline](https://github.com/taosiuman/seedancer/blob/master/references/creative-baseline.md): `references/creative-baseline.md`
- [Character Assets](https://github.com/taosiuman/seedancer/blob/master/references/character-assets.md): `references/character-assets.md`
- [Key Props](https://github.com/taosiuman/seedancer/blob/master/references/prop-assets.md): `references/prop-assets.md`
- [Quality Gates](https://github.com/taosiuman/seedancer/blob/master/references/qa-strict-gates.md): `references/qa-strict-gates.md`

### Directing Systems

- [Scene Router](https://github.com/taosiuman/seedancer/blob/master/references/scene-prototypes.md): `references/scene-prototypes.md`
- [Camera Design](https://github.com/taosiuman/seedancer/blob/master/references/camera-design.md): `references/camera-design.md`
- [Camera-Emotion Sync](https://github.com/taosiuman/seedancer/blob/master/references/camera-emotion-sync.md): `references/camera-emotion-sync.md`
- [Performance Beats](https://github.com/taosiuman/seedancer/blob/master/references/performance-micro-beats.md): `references/performance-micro-beats.md`
- [Lighting Rules](https://github.com/taosiuman/seedancer/blob/master/references/lighting-rules.md): `references/lighting-rules.md`
- [Dialogue Capacity](https://github.com/taosiuman/seedancer/blob/master/references/dialogue-capacity.md): `references/dialogue-capacity.md`
- [Group and Density](https://github.com/taosiuman/seedancer/blob/master/references/grouping-density.md): `references/grouping-density.md`

### Prompt Output

- [Prompt Construction](https://github.com/taosiuman/seedancer/blob/master/references/cinedance-video-prompt.md): `references/cinedance-video-prompt.md`
- [Output Format](https://github.com/taosiuman/seedancer/blob/master/references/output-format.md): `references/output-format.md`
- [JSON API Mode](https://github.com/taosiuman/seedancer/blob/master/references/json-api-mode.md): `references/json-api-mode.md`
- [Storyboard](https://github.com/taosiuman/seedancer/blob/master/references/deliverable-system.md): `references/deliverable-system.md`

### Other components

- **Filmmaker**

## Connections

- Filmmaker → Agent Skill: requests production (evidence: `README.md`)
- Agent Skill → Project Intake: starts at (evidence: `README.md`)
- Project Intake → Script Analysis: continues to (evidence: `README.md`)
- Script Analysis → Creative Baseline: continues to (evidence: `README.md`)
- Creative Baseline → Character Assets: continues to (evidence: `README.md`)
- Character Assets → Key Props: continues to (evidence: `README.md`)
- Key Props → Quality Gates: enters production (evidence: `README.md`)
- Agent Skill → Quality Gates: routes through (evidence: `README.md`)
- Quality Gates → Prompt Construction: constructs prompts (evidence: `README.md`)
- Prompt Construction → Storyboard: produces (evidence: `README.md`)
- Agent Skill → Scene Router: classifies scenes (evidence: `README.md`)
- Agent Skill → Camera Design: applies design (evidence: `README.md`)
- Agent Skill → Camera-Emotion Sync: syncs camera (evidence: `README.md`)
- Agent Skill → Performance Beats: specifies beats (evidence: `README.md`)
- Agent Skill → Lighting Rules: applies lighting (evidence: `README.md`)
- Quality Gates → Dialogue Capacity: checks capacity (evidence: `README.md`)
- Quality Gates → Group and Density: checks density (evidence: `README.md`)
- Prompt Construction → Output Format: conforms to (evidence: `README.md`)
- Prompt Construction → JSON API Mode: can emit (evidence: `README.md`)
