# nateherkai/herk-edit-kit architecture

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

- Interactive diagram: https://gitdiagram.com/nateherkai/herk-edit-kit
- Repository: https://github.com/nateherkai/herk-edit-kit

## Overview

Herk Edit Kit is an agent-oriented video-editing toolkit built around HyperFrames. Its main user workflow is to bring in footage, use editing skills to plan and refine a cut, review a draft, then render; the README also documents transcription, short-form edits, motion-showreels, reusable graphic cards, templates, and validation tools. The supplied tree and excerpts expose selected utility scripts and teaching projects, not the skills or most workflow implementation, so those capabilities are represented at a high level and links are limited to documented relationships.

Main entry points: [`video-projects/first-agent-promo/scenes.jsx`](https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/first-agent-promo/scenes.jsx) (Promo scenes), [`video-projects/clickup-demo/scripts/populate.mjs`](https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/clickup-demo/scripts/populate.mjs) (ClickUp demo population), [`scripts/transcribe-elevenlabs.mjs`](https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/transcribe-elevenlabs.mjs) (Transcription), [`scripts/build-edl-review.mjs`](https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/build-edl-review.mjs) (Cut review page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Editing workflow"]
  node_edit_skills["Agent editing skills"]
  node_transcription["Transcription"]
  node_cut_review["Cut review page"]
  node_transcript_retiming["Transcript retiming"]
  node_short_form["Short-form editing"]
end

subgraph group_design["Motion design"]
  node_showreel["Motion showreel"]
  node_card_library["Motion card library"]
  node_scene_templates["Scene templates"]
end

subgraph group_tools["Review and tools"]
  node_beat_validation["Beat-sync validation"]
  node_preflight["Project preflight<br/>[preflight.mjs]"]
end

subgraph group_examples["Teaching projects"]
  node_first_agent_scenes["Promo scenes<br/>[scenes.jsx]"]
  node_first_agent_animation["Animation runtime<br/>[animations.jsx]"]
  node_clickup_recording["ClickUp flow recording<br/>[record-flows.mjs]"]
  node_clickup_population["ClickUp demo population<br/>[populate.mjs]"]
end

node_editor(("Editor"))

node_editor -->|"requests edit"| node_edit_skills
node_edit_skills -.->|"may transcribe"| node_transcription
node_edit_skills -.->|"prepares review"| node_cut_review
node_editor -->|"requests short"| node_short_form
node_editor -->|"requests showreel"| node_showreel
node_editor -->|"customizes cards"| node_card_library
node_editor -->|"uses templates"| node_scene_templates
node_editor -->|"retimes transcript"| node_transcript_retiming
node_editor -->|"validates beats"| node_beat_validation
node_editor -->|"runs preflight"| node_preflight
node_first_agent_scenes -.->|"uses runtime"| node_first_agent_animation
node_clickup_population -.->|"seeds capture"| node_clickup_recording

click node_transcription "https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/transcribe-elevenlabs.mjs"
click node_cut_review "https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/build-edl-review.mjs"
click node_transcript_retiming "https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/video-use-to-hyperframes-transcript.mjs"
click node_card_library "https://github.com/nateherkai/herk-edit-kit/tree/main/style-library"
click node_scene_templates "https://github.com/nateherkai/herk-edit-kit/tree/main/style-templates"
click node_beat_validation "https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/validate-beat-sync.mjs"
click node_preflight "https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/preflight.mjs"
click node_first_agent_scenes "https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/first-agent-promo/scenes.jsx"
click node_first_agent_animation "https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/first-agent-promo/animations.jsx"
click node_clickup_recording "https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/clickup-demo/scripts/record-flows.mjs"
click node_clickup_population "https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/clickup-demo/scripts/populate.mjs"

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_edit_skills,node_transcription,node_cut_review,node_transcript_retiming,node_short_form toneBlue
class node_showreel,node_card_library,node_scene_templates toneAmber
class node_beat_validation,node_preflight toneMint
class node_first_agent_scenes,node_first_agent_animation,node_clickup_recording,node_clickup_population toneRose
class node_editor toneIndigo
```

## Components

### Editing workflow

- **Agent editing skills**
- [Transcription](https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/transcribe-elevenlabs.mjs): `scripts/transcribe-elevenlabs.mjs`
- [Cut review page](https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/build-edl-review.mjs): `scripts/build-edl-review.mjs`
- [Transcript retiming](https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/video-use-to-hyperframes-transcript.mjs): `scripts/video-use-to-hyperframes-transcript.mjs`
- **Short-form editing**

### Motion design

- **Motion showreel**
- [Motion card library](https://github.com/nateherkai/herk-edit-kit/tree/main/style-library): `style-library`
- [Scene templates](https://github.com/nateherkai/herk-edit-kit/tree/main/style-templates): `style-templates`

### Review and tools

- [Beat-sync validation](https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/validate-beat-sync.mjs): `scripts/validate-beat-sync.mjs`
- [Project preflight](https://github.com/nateherkai/herk-edit-kit/blob/main/scripts/preflight.mjs): `scripts/preflight.mjs`

### Teaching projects

- [Promo scenes](https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/first-agent-promo/scenes.jsx): `video-projects/first-agent-promo/scenes.jsx`
- [Animation runtime](https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/first-agent-promo/animations.jsx): `video-projects/first-agent-promo/animations.jsx`
- [ClickUp flow recording](https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/clickup-demo/scripts/record-flows.mjs): `video-projects/clickup-demo/scripts/record-flows.mjs`
- [ClickUp demo population](https://github.com/nateherkai/herk-edit-kit/blob/main/video-projects/clickup-demo/scripts/populate.mjs): `video-projects/clickup-demo/scripts/populate.mjs`

### Other components

- **Editor**

## Connections

- Editor → Agent editing skills: requests edit (evidence: `README.md`)
- Agent editing skills → Transcription: may transcribe
- Agent editing skills → Cut review page: prepares review
- Editor → Short-form editing: requests short (evidence: `README.md`)
- Editor → Motion showreel: requests showreel (evidence: `README.md`)
- Editor → Motion card library: customizes cards (evidence: `README.md`)
- Editor → Scene templates: uses templates (evidence: `README.md`)
- Editor → Transcript retiming: retimes transcript (evidence: `README.md`)
- Editor → Beat-sync validation: validates beats (evidence: `README.md`)
- Editor → Project preflight: runs preflight (evidence: `README.md`)
- Promo scenes → Animation runtime: uses runtime
- ClickUp demo population → ClickUp flow recording: seeds capture