# itpartypattaya/reels-montage architecture

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

## Overview

IT Reelsmaker is a pair of Claude Code plugins for locally planning, editing, and rendering vertical videos, with an optional online-media add-on. The main workflow is brand/style setup, transcription and retake review, an approval-gated cut, audio-led rough cutting, an approval-gated visual plan, rendering and face/layout checks, then mastering and reporting. Separate branches cover long-form clip series, voice-led scene explainers and mascots, plus optional online footage, memes, and generated video. The README documents the workflow; source-level edges are limited to relationships visible in the supplied excerpts or SOURCE INDEX.

Main entry points: [`plugins/it-reelsmaker/skills/it-reelsmaker/scripts/visual_plan.py`](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/visual_plan.py) (Visual plan), [`plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/reels_online.py`](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/reels_online.py) (Online media add-on), [`plugins/it-reelsmaker/skills/it-reelsmaker/scripts/cut.py`](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/cut.py) (Audio-led rough cut), [`plugins/it-reelsmaker/skills/it-reelsmaker/scripts/kit.py`](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/kit.py) (Remotion render)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Planning and input"]
  node_brand["Brand profiles<br/>[brand.py]"]
  node_transcript["Word transcript<br/>[transcribe.py]"]
  node_retakes["Retake review<br/>[defects.py]"]
  node_cut_plan["Cut approval plan<br/>[structure.py]"]
  node_longform["Long-form clips<br/>[longform.py]"]
end

subgraph group_edit["Cut and visuals"]
  node_rough_cut["Audio-led rough cut<br/>[cut.py]"]
  node_speech_mask["Speech boundaries<br/>[speech_mask.py]"]
  node_visual_plan["Visual plan<br/>[visual_plan.py]"]
  node_footage["Footage library<br/>[footage.py]"]
  node_camera["Virtual camera<br/>[vp_camera.py]"]
  node_scene_design["Designed scenes<br/>[vp_scenes.py]"]
  node_mascot["Mascot animation<br/>[mascot_atlas.py]"]
  node_shared["Project helpers<br/>[reels_common.py]"]
end

subgraph group_render["Render and quality"]
  node_face_check["Face-aware layout<br/>[faces.py]"]
  node_render_output["Remotion render<br/>[kit.py]"]
  node_master_audio["Audio mastering<br/>[master_audio.py]"]
  node_subtitles["Subtitle files<br/>[subs.py]"]
  node_report["Edit report<br/>[check.py]"]
end

subgraph group_extensions["Optional capabilities"]
  node_online["Online media add-on<br/>[reels_online.py]"]
  node_stock["Stock footage<br/>[stock.py]"]
  node_online_meme["Licensed memes<br/>[memes_online.py]"]
  node_generated["Generated footage<br/>[genfootage.py]"]
end

node_creator(("Creator / Claude"))

node_creator -->|"sets style"| node_brand
node_creator -->|"starts edit"| node_transcript
node_transcript -->|"reviews retakes"| node_retakes
node_retakes -->|"informs plan"| node_cut_plan
node_creator -->|"approves cut"| node_cut_plan
node_cut_plan -->|"defines cuts"| node_rough_cut
node_rough_cut -->|"uses boundaries"| node_speech_mask
node_rough_cut -->|"provides captions"| node_visual_plan
node_creator -->|"approves visuals"| node_visual_plan
node_visual_plan -->|"selects B-roll"| node_footage
node_visual_plan -->|"plans scenes"| node_scene_design
node_visual_plan -->|"plans framing"| node_camera
node_visual_plan -->|"checks layout"| node_face_check
node_visual_plan -->|"feeds render"| node_render_output
node_render_output -->|"master audio"| node_master_audio
node_render_output -->|"writes subtitles"| node_subtitles
node_master_audio -->|"checks loudness"| node_report
node_longform -->|"offers clip cards"| node_creator
node_mascot -.->|"animates character"| node_scene_design
node_footage -->|"loads add-on"| node_online
node_online -->|"dispatches stock"| node_stock
node_online -->|"dispatches memes"| node_online_meme
node_online -->|"dispatches generation"| node_generated
node_visual_plan -->|"uses helpers"| node_shared

click node_brand "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/brand.py"
click node_transcript "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/transcribe.py"
click node_retakes "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/defects.py"
click node_cut_plan "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/structure.py"
click node_rough_cut "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/cut.py"
click node_speech_mask "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/speech_mask.py"
click node_visual_plan "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/visual_plan.py"
click node_footage "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/footage.py"
click node_camera "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/vp_camera.py"
click node_scene_design "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/vp_scenes.py"
click node_face_check "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/faces.py"
click node_render_output "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/kit.py"
click node_master_audio "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/master_audio.py"
click node_subtitles "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/subs.py"
click node_report "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/check.py"
click node_longform "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/longform.py"
click node_mascot "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/mascot_atlas.py"
click node_online "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/reels_online.py"
click node_stock "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/stock.py"
click node_online_meme "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/memes_online.py"
click node_generated "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/genfootage.py"
click node_shared "https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/reels_common.py"

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_brand,node_transcript,node_retakes,node_cut_plan,node_longform toneBlue
class node_rough_cut,node_speech_mask,node_visual_plan,node_footage,node_camera,node_scene_design,node_mascot,node_shared toneAmber
class node_face_check,node_render_output,node_master_audio,node_subtitles,node_report toneMint
class node_online,node_stock,node_online_meme,node_generated toneRose
class node_creator toneIndigo
```

## Components

### Planning and input

- [Brand profiles](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/brand.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/brand.py`
- [Word transcript](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/transcribe.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/transcribe.py`
- [Retake review](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/defects.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/defects.py`
- [Cut approval plan](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/structure.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/structure.py`
- [Long-form clips](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/longform.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/longform.py`

### Cut and visuals

- [Audio-led rough cut](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/cut.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/cut.py`
- [Speech boundaries](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/speech_mask.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/speech_mask.py`
- [Visual plan](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/visual_plan.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/visual_plan.py`
- [Footage library](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/footage.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/footage.py`
- [Virtual camera](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/vp_camera.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/vp_camera.py`
- [Designed scenes](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/vp_scenes.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/vp_scenes.py`
- [Mascot animation](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/mascot_atlas.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/mascot_atlas.py`
- [Project helpers](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/reels_common.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/reels_common.py`

### Render and quality

- [Face-aware layout](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/faces.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/faces.py`
- [Remotion render](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/kit.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/kit.py`
- [Audio mastering](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/master_audio.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/master_audio.py`
- [Subtitle files](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/subs.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/subs.py`
- [Edit report](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker/skills/it-reelsmaker/scripts/check.py): `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/check.py`

### Optional capabilities

- [Online media add-on](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/reels_online.py): `plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/reels_online.py`
- [Stock footage](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/stock.py): `plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/stock.py`
- [Licensed memes](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/memes_online.py): `plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/memes_online.py`
- [Generated footage](https://github.com/itpartypattaya/reels-montage/blob/main/plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/genfootage.py): `plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/genfootage.py`

### Other components

- **Creator / Claude**

## Connections

- Creator / Claude → Brand profiles: sets style (evidence: `README.md`)
- Creator / Claude → Word transcript: starts edit (evidence: `README.md`)
- Word transcript → Retake review: reviews retakes (evidence: `README.md`)
- Retake review → Cut approval plan: informs plan (evidence: `README.md`)
- Creator / Claude → Cut approval plan: approves cut (evidence: `README.md`)
- Cut approval plan → Audio-led rough cut: defines cuts (evidence: `README.md`)
- Audio-led rough cut → Speech boundaries: uses boundaries (evidence: `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/structure.py`)
- Audio-led rough cut → Visual plan: provides captions (evidence: `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/visual_plan.py`)
- Creator / Claude → Visual plan: approves visuals (evidence: `README.md`)
- Visual plan → Footage library: selects B-roll (evidence: `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/footage.py`)
- Visual plan → Designed scenes: plans scenes (evidence: `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/visual_plan.py`)
- Visual plan → Virtual camera: plans framing (evidence: `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/visual_plan.py`)
- Visual plan → Face-aware layout: checks layout (evidence: `README.md`)
- Visual plan → Remotion render: feeds render (evidence: `README.md`)
- Remotion render → Audio mastering: master audio (evidence: `README.md`)
- Remotion render → Subtitle files: writes subtitles (evidence: `README.md`)
- Audio mastering → Edit report: checks loudness (evidence: `README.md`)
- Long-form clips → Creator / Claude: offers clip cards (evidence: `README.md`)
- Mascot animation → Designed scenes: animates character
- Footage library → Online media add-on: loads add-on (evidence: `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/footage.py`)
- Online media add-on → Stock footage: dispatches stock (evidence: `plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/reels_online.py`)
- Online media add-on → Licensed memes: dispatches memes (evidence: `plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/reels_online.py`)
- Online media add-on → Generated footage: dispatches generation (evidence: `plugins/it-reelsmaker-online/skills/it-reelsmaker-online/scripts/reels_online.py`)
- Visual plan → Project helpers: uses helpers (evidence: `plugins/it-reelsmaker/skills/it-reelsmaker/scripts/visual_plan.py`)
