# felpborges/claude-video architecture

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

- Interactive diagram: https://gitdiagram.com/felpborges/claude-video
- Repository: https://github.com/felpborges/claude-video

## Overview

claude-video is a Portuguese Claude Code skill for producing studio-style motion graphics. The user chooses a reference style or supplies references, answers a five-question brief, reviews reference analysis and storyboard/cards/frames, then receives a rendered MP4 with rhythm, loop (when applicable), and reference-motion checks. The README documents this workflow and several script capabilities not present in the supplied tree; those are represented at the supported scripts/ subsystem level. Source excerpts also show representative style projects, including the airplane film’s renderer and scene modules.

Main entry points: [`scripts`](https://github.com/felpborges/claude-video/tree/main/scripts) (MP4 render), [`scripts/storyboard.py`](https://github.com/felpborges/claude-video/blob/main/scripts/storyboard.py) (Storyboard), [`estilos/aviao-em-codigo/projeto/motor.js`](https://github.com/felpborges/claude-video/blob/main/estilos/aviao-em-codigo/projeto/motor.js) (Airplane film motor), [`perguntas.md`](https://github.com/felpborges/claude-video/blob/main/perguntas.md) (Five-question brief)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Creative workflow"]
  node_brief["Five-question brief<br/>[perguntas.md]"]
  node_approval_cards["Card approval"]
  node_frame_approval["Frame approval"]
  node_render["MP4 render"]
  node_video["Finished video"]
end

subgraph group_analysis["Reference and planning"]
  node_reference_analysis["Reference analysis"]
  node_storyboard["Storyboard<br/>[storyboard.py]"]
  node_rhythm_check["Rhythm check<br/>[ritmo.py]"]
  node_loop_check["Loop check<br/>[loop.py]"]
  node_motion_check["Motion comparison"]
end

subgraph group_media["Media integrations"]
  node_media_choice["Media choice<br/>[_midia.py]"]
  node_higgsfield["Higgsfield clips<br/>[higgsfield.py]"]
end

subgraph group_styles["Style gallery and projects"]
  node_style_gallery["Style gallery<br/>[galeria.py]"]
  node_style_catalog["Style catalog<br/>[estilos.js]"]
  node_style_projects["Reference projects"]
  node_aircraft_motor["Airplane film motor<br/>[motor.js]"]
  node_aircraft_model["Procedural airplane<br/>[plane.js]"]
  node_aircraft_real["Photographic airplane<br/>[real.js]"]
end

node_creator(("Creator"))
node_claude(("Claude Code"))

node_creator -->|"requests video"| node_claude
node_creator -->|"chooses style"| node_style_gallery
node_style_gallery -.->|"lists styles"| node_style_catalog
node_style_catalog -.->|"references projects"| node_style_projects
node_creator -->|"answers questions"| node_brief
node_creator -->|"provides references"| node_reference_analysis
node_claude -->|"analyzes reference"| node_reference_analysis
node_claude -->|"builds plan"| node_storyboard
node_storyboard -->|"presents cards"| node_approval_cards
node_approval_cards -->|"requests approval"| node_creator
node_claude -->|"presents frames"| node_frame_approval
node_frame_approval -->|"requests approval"| node_creator
node_brief -->|"specifies media"| node_media_choice
node_storyboard -.->|"plans AI clips"| node_higgsfield
node_higgsfield -.->|"returns clips"| node_storyboard
node_claude -->|"renders MP4"| node_render
node_render -->|"checks rhythm"| node_rhythm_check
node_render -->|"checks loop"| node_loop_check
node_render -->|"compares motion"| node_motion_check
node_render -->|"produces MP4"| node_video
node_aircraft_motor -->|"creates model"| node_aircraft_model
node_aircraft_motor -->|"creates real layer"| node_aircraft_real

click node_style_gallery "https://github.com/felpborges/claude-video/blob/main/scripts/galeria.py"
click node_style_catalog "https://github.com/felpborges/claude-video/blob/main/galeria/estilos.js"
click node_style_projects "https://github.com/felpborges/claude-video/tree/main/estilos"
click node_brief "https://github.com/felpborges/claude-video/blob/main/perguntas.md"
click node_reference_analysis "https://github.com/felpborges/claude-video/blob/main/scripts/pericia-movimento.py"
click node_storyboard "https://github.com/felpborges/claude-video/blob/main/scripts/storyboard.py"
click node_approval_cards "https://github.com/felpborges/claude-video/tree/main/scripts"
click node_frame_approval "https://github.com/felpborges/claude-video/tree/main/scripts"
click node_media_choice "https://github.com/felpborges/claude-video/blob/main/scripts/_midia.py"
click node_higgsfield "https://github.com/felpborges/claude-video/blob/main/scripts/higgsfield.py"
click node_render "https://github.com/felpborges/claude-video/tree/main/scripts"
click node_rhythm_check "https://github.com/felpborges/claude-video/blob/main/scripts/ritmo.py"
click node_loop_check "https://github.com/felpborges/claude-video/blob/main/scripts/loop.py"
click node_motion_check "https://github.com/felpborges/claude-video/blob/main/scripts/pericia-movimento.py"
click node_aircraft_motor "https://github.com/felpborges/claude-video/blob/main/estilos/aviao-em-codigo/projeto/motor.js"
click node_aircraft_model "https://github.com/felpborges/claude-video/blob/main/estilos/aviao-em-codigo/projeto/plane.js"
click node_aircraft_real "https://github.com/felpborges/claude-video/blob/main/estilos/aviao-em-codigo/projeto/real.js"

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_brief,node_approval_cards,node_frame_approval,node_render,node_video toneBlue
class node_reference_analysis,node_storyboard,node_rhythm_check,node_loop_check,node_motion_check toneAmber
class node_media_choice,node_higgsfield toneMint
class node_style_gallery,node_style_catalog,node_style_projects,node_aircraft_motor,node_aircraft_model,node_aircraft_real toneRose
class node_creator,node_claude toneIndigo
```

## Components

### Creative workflow

- [Five-question brief](https://github.com/felpborges/claude-video/blob/main/perguntas.md): `perguntas.md`
- [Card approval](https://github.com/felpborges/claude-video/tree/main/scripts): `scripts`
- [Frame approval](https://github.com/felpborges/claude-video/tree/main/scripts): `scripts`
- [MP4 render](https://github.com/felpborges/claude-video/tree/main/scripts): `scripts`
- **Finished video**

### Reference and planning

- [Reference analysis](https://github.com/felpborges/claude-video/blob/main/scripts/pericia-movimento.py): `scripts/pericia-movimento.py`
- [Storyboard](https://github.com/felpborges/claude-video/blob/main/scripts/storyboard.py): `scripts/storyboard.py`
- [Rhythm check](https://github.com/felpborges/claude-video/blob/main/scripts/ritmo.py): `scripts/ritmo.py`
- [Loop check](https://github.com/felpborges/claude-video/blob/main/scripts/loop.py): `scripts/loop.py`
- [Motion comparison](https://github.com/felpborges/claude-video/blob/main/scripts/pericia-movimento.py): `scripts/pericia-movimento.py`

### Media integrations

- [Media choice](https://github.com/felpborges/claude-video/blob/main/scripts/_midia.py): `scripts/_midia.py`
- [Higgsfield clips](https://github.com/felpborges/claude-video/blob/main/scripts/higgsfield.py): `scripts/higgsfield.py`

### Style gallery and projects

- [Style gallery](https://github.com/felpborges/claude-video/blob/main/scripts/galeria.py): `scripts/galeria.py`
- [Style catalog](https://github.com/felpborges/claude-video/blob/main/galeria/estilos.js): `galeria/estilos.js`
- [Reference projects](https://github.com/felpborges/claude-video/tree/main/estilos): `estilos`
- [Airplane film motor](https://github.com/felpborges/claude-video/blob/main/estilos/aviao-em-codigo/projeto/motor.js): `estilos/aviao-em-codigo/projeto/motor.js`
- [Procedural airplane](https://github.com/felpborges/claude-video/blob/main/estilos/aviao-em-codigo/projeto/plane.js): `estilos/aviao-em-codigo/projeto/plane.js`
- [Photographic airplane](https://github.com/felpborges/claude-video/blob/main/estilos/aviao-em-codigo/projeto/real.js): `estilos/aviao-em-codigo/projeto/real.js`

### Other components

- **Creator**
- **Claude Code**

## Connections

- Creator → Claude Code: requests video (evidence: `README.md`)
- Creator → Style gallery: chooses style (evidence: `README.md`)
- Style gallery → Style catalog: lists styles
- Style catalog → Reference projects: references projects
- Creator → Five-question brief: answers questions (evidence: `README.md`)
- Creator → Reference analysis: provides references (evidence: `README.md`)
- Claude Code → Reference analysis: analyzes reference (evidence: `README.md`)
- Claude Code → Storyboard: builds plan (evidence: `README.md`)
- Storyboard → Card approval: presents cards (evidence: `README.md`)
- Card approval → Creator: requests approval (evidence: `README.md`)
- Claude Code → Frame approval: presents frames (evidence: `README.md`)
- Frame approval → Creator: requests approval (evidence: `README.md`)
- Five-question brief → Media choice: specifies media (evidence: `README.md`)
- Storyboard → Higgsfield clips: plans AI clips
- Higgsfield clips → Storyboard: returns clips
- Claude Code → MP4 render: renders MP4 (evidence: `README.md`)
- MP4 render → Rhythm check: checks rhythm (evidence: `README.md`)
- MP4 render → Loop check: checks loop (evidence: `README.md`)
- MP4 render → Motion comparison: compares motion (evidence: `README.md`)
- MP4 render → Finished video: produces MP4 (evidence: `README.md`)
- Airplane film motor → Procedural airplane: creates model (evidence: `estilos/aviao-em-codigo/projeto/motor.js`)
- Airplane film motor → Photographic airplane: creates real layer (evidence: `estilos/aviao-em-codigo/projeto/motor.js`)
