# echris6/motion-video-kit architecture

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

- Interactive diagram: https://gitdiagram.com/echris6/motion-video-kit
- Repository: https://github.com/echris6/motion-video-kit

## Overview

Motion Video Kit is an LLM-oriented skill and production toolkit for creating and reviewing premium business commercials. The main workflow starts with a user request, uses the skill and its business, visual, and audio guidance to shape a film, then applies an independent-critic loop and quality checks before delivery. Scripts and templates support selected production tasks. The README documents these capabilities, but most implementation details of the workflow are in unsampled references; edges therefore show documented relationships, not a fully verified runtime call graph.

Main entry points: [`business-motion-film/SKILL.md`](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/SKILL.md) (Film Skill), [`business-motion-film/references/audio.md`](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/audio.md) (Audio Guidance), [`business-motion-film/references/three-js-patterns.md`](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/three-js-patterns.md) (Three.js Patterns), [`business-motion-film/references/gauntlet.md`](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/gauntlet.md) (Gauntlet Review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Film Workflow"]
  node_skill["Film Skill<br/>[SKILL.md]"]
  node_offers["Business Playbook<br/>[business-offers.md]"]
  node_alder["Service Case Study"]
  node_duo["Product Case Study<br/>[case-study-duo.md]"]
end

subgraph group_visual["Visual Craft"]
  node_motion["Motion Grammar<br/>[motion-grammar.md]"]
  node_filmnotes["Film References"]
  node_three["Three.js Patterns"]
  node_realism["Product Realism"]
  node_overlays["Projected Overlays"]
end

subgraph group_audio["Audio Craft"]
  node_audio["Audio Guidance<br/>[audio.md]"]
  node_candidate["SFX Candidate Analysis<br/>[sfx-candidates.py]"]
  node_gain["SFX Gain Solver<br/>[solve-sfx-gains.py]"]
  node_mix["Offline Audio Mix<br/>[offline-mix.py]"]
end

subgraph group_review["Review And Quality"]
  node_gauntlet["Gauntlet Review<br/>[gauntlet.md]"]
  node_critics["Critic Prompts<br/>[critic-prompts.md]"]
  node_quality["Quality Bar<br/>[quality-bar.md]"]
end

subgraph group_tools["Production Tools"]
  node_lab["Component Lab<br/>[component-lab.html]"]
  node_scripts["Render Checks"]
end

node_user(("Film Maker"))
node_film["Commercial Film"]
node_ffmpeg["FFmpeg"]
node_hyperframes["HyperFrames"]

node_user -->|"requests film"| node_skill
node_skill -->|"uses playbook"| node_offers
node_skill -->|"uses grammar"| node_motion
node_skill -->|"uses rules"| node_audio
node_skill -->|"uses patterns"| node_three
node_skill -->|"runs review"| node_gauntlet
node_skill -->|"checks criteria"| node_quality
node_skill -->|"draws lessons"| node_alder
node_skill -->|"draws lessons"| node_duo
node_motion -->|"catalogs mechanisms"| node_filmnotes
node_three -->|"includes realism guidance"| node_realism
node_three -->|"uses projected callouts"| node_overlays
node_audio -->|"screens effects"| node_candidate
node_audio -->|"solves effect levels"| node_gain
node_audio -->|"guides final mix"| node_mix
node_gauntlet -->|"uses prompts"| node_critics
node_skill -->|"guides creation"| node_film
node_gauntlet -->|"critiques render"| node_film
node_quality -->|"checks readiness"| node_film
node_scripts -->|"uses media tools"| node_ffmpeg
node_lab -.->|"optionally renders with"| node_hyperframes
node_film -->|"delivers result"| node_user

click node_skill "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/SKILL.md"
click node_offers "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/business-offers.md"
click node_alder "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/case-study-alder.md"
click node_duo "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/case-study-duo.md"
click node_motion "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/motion-grammar.md"
click node_filmnotes "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/launch-film-notes.md"
click node_three "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/three-js-patterns.md"
click node_realism "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/product-hero-realism.md"
click node_overlays "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/templates/projected-overlays.js"
click node_audio "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/audio.md"
click node_candidate "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/scripts/sfx-candidates.py"
click node_gain "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/scripts/solve-sfx-gains.py"
click node_mix "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/scripts/offline-mix.py"
click node_gauntlet "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/gauntlet.md"
click node_critics "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/critic-prompts.md"
click node_quality "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/quality-bar.md"
click node_lab "https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/templates/component-lab.html"
click node_scripts "https://github.com/echris6/motion-video-kit/tree/main/business-motion-film/scripts"

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_offers,node_alder,node_duo toneBlue
class node_motion,node_filmnotes,node_three,node_realism,node_overlays toneAmber
class node_audio,node_candidate,node_gain,node_mix toneMint
class node_gauntlet,node_critics,node_quality toneRose
class node_lab,node_scripts,node_user,node_film,node_ffmpeg,node_hyperframes toneIndigo
```

## Components

### Film Workflow

- [Film Skill](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/SKILL.md): `business-motion-film/SKILL.md`
- [Business Playbook](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/business-offers.md): `business-motion-film/references/business-offers.md`
- [Service Case Study](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/case-study-alder.md): `business-motion-film/references/case-study-alder.md`
- [Product Case Study](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/case-study-duo.md): `business-motion-film/references/case-study-duo.md`

### Visual Craft

- [Motion Grammar](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/motion-grammar.md): `business-motion-film/references/motion-grammar.md`
- [Film References](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/launch-film-notes.md): `business-motion-film/references/launch-film-notes.md`
- [Three.js Patterns](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/three-js-patterns.md): `business-motion-film/references/three-js-patterns.md`
- [Product Realism](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/product-hero-realism.md): `business-motion-film/references/product-hero-realism.md`
- [Projected Overlays](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/templates/projected-overlays.js): `business-motion-film/templates/projected-overlays.js`

### Audio Craft

- [Audio Guidance](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/audio.md): `business-motion-film/references/audio.md`
- [SFX Candidate Analysis](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/scripts/sfx-candidates.py): `business-motion-film/scripts/sfx-candidates.py`
- [SFX Gain Solver](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/scripts/solve-sfx-gains.py): `business-motion-film/scripts/solve-sfx-gains.py`
- [Offline Audio Mix](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/scripts/offline-mix.py): `business-motion-film/scripts/offline-mix.py`

### Review And Quality

- [Gauntlet Review](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/gauntlet.md): `business-motion-film/references/gauntlet.md`
- [Critic Prompts](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/critic-prompts.md): `business-motion-film/references/critic-prompts.md`
- [Quality Bar](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/references/quality-bar.md): `business-motion-film/references/quality-bar.md`

### Production Tools

- [Component Lab](https://github.com/echris6/motion-video-kit/blob/main/business-motion-film/templates/component-lab.html): `business-motion-film/templates/component-lab.html`
- [Render Checks](https://github.com/echris6/motion-video-kit/tree/main/business-motion-film/scripts): `business-motion-film/scripts`

### Other components

- **Film Maker**
- **Commercial Film**
- **FFmpeg**
- **HyperFrames**

## Connections

- Film Maker → Film Skill: requests film (evidence: `README.md`)
- Film Skill → Business Playbook: uses playbook (evidence: `README.md`)
- Film Skill → Motion Grammar: uses grammar (evidence: `README.md`)
- Film Skill → Audio Guidance: uses rules (evidence: `README.md`)
- Film Skill → Three.js Patterns: uses patterns (evidence: `README.md`)
- Film Skill → Gauntlet Review: runs review (evidence: `README.md`)
- Film Skill → Quality Bar: checks criteria (evidence: `README.md`)
- Film Skill → Service Case Study: draws lessons (evidence: `README.md`)
- Film Skill → Product Case Study: draws lessons (evidence: `README.md`)
- Motion Grammar → Film References: catalogs mechanisms (evidence: `README.md`)
- Three.js Patterns → Product Realism: includes realism guidance (evidence: `README.md`)
- Three.js Patterns → Projected Overlays: uses projected callouts (evidence: `README.md`)
- Audio Guidance → SFX Candidate Analysis: screens effects (evidence: `README.md`)
- Audio Guidance → SFX Gain Solver: solves effect levels (evidence: `README.md`)
- Audio Guidance → Offline Audio Mix: guides final mix (evidence: `README.md`)
- Gauntlet Review → Critic Prompts: uses prompts (evidence: `README.md`)
- Film Skill → Commercial Film: guides creation (evidence: `README.md`)
- Gauntlet Review → Commercial Film: critiques render (evidence: `README.md`)
- Quality Bar → Commercial Film: checks readiness (evidence: `README.md`)
- Render Checks → FFmpeg: uses media tools (evidence: `README.md`)
- Component Lab → HyperFrames: optionally renders with (evidence: `README.md`)
- Commercial Film → Film Maker: delivers result (evidence: `README.md`)
