# vicky8106/code-to-reels architecture

> Architecture diagram of the GitHub repository vicky8106/code-to-reels, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vicky8106/code-to-reels
- Repository: https://github.com/vicky8106/code-to-reels

## Overview

code-to-reels is an Agent Skill for planning and producing short-form animated explainers through human approval gates. Its principal workflow moves from brand and asset preparation to five-beat boards, animation, rendering with sound, and a post-release data loop. The graph combines that documented workflow with the sampled scene generator and sound kit; source excerpts do not establish every implementation-level connection, so uncertain links are omitted.

Main entry points: [`burton-motion-videos/SKILL.md`](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md) (Skill workflow), [`burton-motion-videos/scripts/museum_scene.py`](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/scripts/museum_scene.py) (Scene generator), [`burton-motion-videos/scripts/sfx_kit.py`](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/scripts/sfx_kit.py) (Sound synthesis), [`examples/museum-spot-the-flaw/museum_video.py`](https://github.com/vicky8106/code-to-reels/blob/main/examples/museum-spot-the-flaw/museum_video.py) (Worked example)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Production workflow"]
  node_skill["Skill workflow<br/>[SKILL.md]"]
  node_prereqs["Prerequisites<br/>[SKILL.md]"]
  node_assets["Brand assets<br/>[SKILL.md]"]
  node_boards["Five beat boards<br/>[SKILL.md]"]
  node_motion["Motion pass<br/>[SKILL.md]"]
  node_render["Render and sound<br/>[SKILL.md]"]
end

subgraph group_craft["Design guidance"]
  node_design["Asset design<br/>[asset-design.md]"]
  node_language["Motion language<br/>[motion-language.md]"]
  node_pipeline["Render guidance<br/>[render-pipeline.md]"]
end

subgraph group_code["Rendering code"]
  node_scene["Scene generator<br/>[museum_scene.py]"]
  node_transitions["Transition patterns"]
  node_sfx["Sound synthesis<br/>[sfx_kit.py]"]
  node_buzz["Buzz loop<br/>[burt-wing-buzz.wav]"]
  node_renderer["SVG and video tools"]
  node_example["Worked example<br/>[museum_video.py]"]
  node_video["Example short"]
end

subgraph group_feedback["Release feedback"]
  node_data["Data loop<br/>[SKILL.md]"]
end

node_agent(("Agent / creator"))
node_retention["Retention results"]

node_agent -->|"follows"| node_skill
node_skill -->|"starts with"| node_prereqs
node_prereqs -->|"approve gate"| node_assets
node_assets -->|"approve gate"| node_boards
node_boards -->|"approve gate"| node_motion
node_motion -->|"approve gate"| node_render
node_agent -->|"consults"| node_design
node_agent -->|"consults"| node_language
node_agent -->|"consults"| node_pipeline
node_agent -->|"authors with"| node_scene
node_agent -->|"adapts patterns"| node_transitions
node_agent -->|"uses kit"| node_sfx
node_sfx -->|"reads"| node_buzz
node_scene -->|"produces SVG"| node_renderer
node_renderer -->|"renders"| node_video
node_agent -->|"runs example"| node_example
node_example -->|"produces"| node_video
node_render -->|"feeds"| node_data
node_retention -->|"informs next cut"| node_data

click node_skill "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md"
click node_prereqs "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md"
click node_assets "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md"
click node_boards "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md"
click node_motion "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md"
click node_render "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md"
click node_design "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/references/asset-design.md"
click node_language "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/references/motion-language.md"
click node_pipeline "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/references/render-pipeline.md"
click node_scene "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/scripts/museum_scene.py"
click node_transitions "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/scripts/transitions_test.py"
click node_sfx "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/scripts/sfx_kit.py"
click node_buzz "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/assets/burt-wing-buzz.wav"
click node_example "https://github.com/vicky8106/code-to-reels/blob/main/examples/museum-spot-the-flaw/museum_video.py"
click node_video "https://github.com/vicky8106/code-to-reels/blob/main/examples/museum-spot-the-flaw/museum-spot-the-flaw.mp4"
click node_data "https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.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_prereqs,node_assets,node_boards,node_motion,node_render toneBlue
class node_design,node_language,node_pipeline toneAmber
class node_scene,node_transitions,node_sfx,node_buzz,node_renderer,node_example,node_video toneMint
class node_data toneRose
class node_agent,node_retention toneIndigo
```

## Components

### Production workflow

- [Skill workflow](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md): `burton-motion-videos/SKILL.md`
- [Prerequisites](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md): `burton-motion-videos/SKILL.md`
- [Brand assets](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md): `burton-motion-videos/SKILL.md`
- [Five beat boards](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md): `burton-motion-videos/SKILL.md`
- [Motion pass](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md): `burton-motion-videos/SKILL.md`
- [Render and sound](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md): `burton-motion-videos/SKILL.md`

### Design guidance

- [Asset design](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/references/asset-design.md): `burton-motion-videos/references/asset-design.md`
- [Motion language](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/references/motion-language.md): `burton-motion-videos/references/motion-language.md`
- [Render guidance](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/references/render-pipeline.md): `burton-motion-videos/references/render-pipeline.md`

### Rendering code

- [Scene generator](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/scripts/museum_scene.py): `burton-motion-videos/scripts/museum_scene.py`
- [Transition patterns](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/scripts/transitions_test.py): `burton-motion-videos/scripts/transitions_test.py`
- [Sound synthesis](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/scripts/sfx_kit.py): `burton-motion-videos/scripts/sfx_kit.py`
- [Buzz loop](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/assets/burt-wing-buzz.wav): `burton-motion-videos/assets/burt-wing-buzz.wav`
- **SVG and video tools**
- [Worked example](https://github.com/vicky8106/code-to-reels/blob/main/examples/museum-spot-the-flaw/museum_video.py): `examples/museum-spot-the-flaw/museum_video.py`
- [Example short](https://github.com/vicky8106/code-to-reels/blob/main/examples/museum-spot-the-flaw/museum-spot-the-flaw.mp4): `examples/museum-spot-the-flaw/museum-spot-the-flaw.mp4`

### Release feedback

- [Data loop](https://github.com/vicky8106/code-to-reels/blob/main/burton-motion-videos/SKILL.md): `burton-motion-videos/SKILL.md`

### Other components

- **Agent / creator**
- **Retention results**

## Connections

- Agent / creator → Skill workflow: follows
- Skill workflow → Prerequisites: starts with
- Prerequisites → Brand assets: approve gate
- Brand assets → Five beat boards: approve gate
- Five beat boards → Motion pass: approve gate
- Motion pass → Render and sound: approve gate
- Agent / creator → Asset design: consults
- Agent / creator → Motion language: consults
- Agent / creator → Render guidance: consults
- Agent / creator → Scene generator: authors with
- Agent / creator → Transition patterns: adapts patterns
- Agent / creator → Sound synthesis: uses kit
- Sound synthesis → Buzz loop: reads
- Scene generator → SVG and video tools: produces SVG
- SVG and video tools → Example short: renders
- Agent / creator → Worked example: runs example
- Worked example → Example short: produces
- Render and sound → Data loop: feeds
- Retention results → Data loop: informs next cut