HyperFrames – Lesen Sie dies zuerst
Starten Sie hier für jede HyperFrames-Aufgabe – besonders wenn keine Projekt-Agentenkonfiguration (CLAUDE.md / AGENTS.md / .cursorrules) vorhanden ist. Fähigkeitskarte + Video-Router unten.
Fähigkeitskarte – welcher Skill für welche Absicht
| Sie möchten… | Gehe zu |
|---|---|
| Ein Video erstellen (von einer URL, einer Kurzbeschreibung, einem Thema, einem GitHub-PR, vorhandenem Filmmaterial oder einem einzelnen zu animierenden Element) | dem Video-Router unten (§ Video-Routing) |
Eine HTML-Komposition erstellen / bearbeiten – den data-* Vertrag, Clips, Spuren, Unterkompositionen, Variablen | /hyperframes-core |
| Animieren – Atomare Bewegungsregeln, Szenen-Blaupausen, Übergänge, Laufzeit-Adapter (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Kreative Leitung – design.md, Paletten, Typografie, Erzählung, Taktplanung, audio-reaktiv | /hyperframes-creative |
| Medienvorverarbeitung – TTS-Sprachausgabe, Hintergrundmusik, Transkription, Hintergrundentfernung, Untertitel | /hyperframes-media |
| CLI-Entwicklungszyklus – init, lint, validieren, inspizieren, Vorschau, rendern, veröffentlichen, doctor | /hyperframes-cli |
Registry-Blöcke / Komponenten installieren (hyperframes add) | /hyperframes-registry |
Der Kompositions-Authoring-Vertrag (jedes zeitgesteuerte Element benötigt
data-start/data-duration/data-track-index; zeitgesteuerte Elemente benötigenclass="clip"; GSAP-Timelines werden pausiert und aufwindow.__timelinesregistriert; nur deterministische Logik – keinDate.now()/Math.random()/ Netzwerk) wird hier nicht dupliziert – er lebt in/hyperframes-core. Lesen Sie diesen, bevor Sie Kompositions-HTML schreiben.
Was HyperFrames nicht kann – Überprüfen Sie dies zuerst
HyperFrames erstellt eine HTML-Komposition und rendert sie aus Code in MP4. Dieses Modell hat harte äußere Grenzen. Eine Anfrage, die darüber hinausgeht, ist keine Routing-Entscheidung – sie ist außerhalb des Rahmens, lehnen Sie sie daher ab (oder verweisen Sie auf das richtige Tool), anstatt nach einem Workflow zu greifen. Diese ergeben sich aus der Architektur, nicht aus einer einzelnen Anfrage:
- Der Render-Vorgang ist deterministisch und in sich geschlossen. Jeder Wert, jedes Asset und jeder Text wird beim Authoring eingebrannt; der Render-Vorgang führt keinen Netzwerkaufruf und keinen Live-/Renderzeit-Datenabruf durch (Grundregel: kein
Date.now()/Math.random()/ Netzwerk). „Zahlen zur Renderzeit live aktualisieren“ ist nicht möglich – holen Sie die Daten einmalig zur Authoring-Zeit und brennen Sie sie ein, oder lehnen Sie ab. - Vorhandenes Video wird überlagert, niemals bearbeitet. HyperFrames komponiert Bilder über einem Quellclip –
/embedded-captionsfügt eine Untertitelebene hinzu,/graphic-overlaysfügt gestaltete Grafikkarten hinzu (Lower Thirds, Datenhinweise, Titel) – und der Clip läuft unverändert darunter, aber keines dieser Verfahren bearbeitet den codierten Videostream nachträglich. Das Ändern des Filmmaterials selbst (sein Timing, seine Farbe, sein Bildausschnitt, seine Reihenfolge oder sein Audio) ist eine NLE-ähnliche Bearbeitung und nicht zulässig. - Der Remotion-Import ist unidirektional.
/remotion-to-hyperframesübersetzt die Remotion-Framework-Quelle in HyperFrames. Es gibt keine Umkehrung (HyperFrames → Remotion oder → ein anderes Framework – nicht zulässig), und eine Nicht-Remotion-React-/Web-Animation-Quelle hat keine Remotion-Quelle zum Übersetzen – erstellen Sie sie über/general-videoneu. - Es kann keine Eingaben erzeugen, die es nicht hat. Keine Bildschirm-/Sitzungsaufzeichnung, keine Kameraaufnahme, keine KI-Talking-Head-/Lip-Sync-Avatar-Generierung. Wenn das Filmmaterial oder Asset noch nicht existiert, kann HyperFrames es nicht herbeizaubern – bitten Sie den Benutzer, es bereitzustellen (oder das richtige Aufnahmewerkzeug zu verwenden), zuerst.
Alles andere – ein Video von einer URL, Kurzbeschreibung, einem Thema, PR, Filmmaterial zum Kommentieren oder einem einzelnen zu animierenden Element – ist zulässig; leiten Sie es unten weiter.
Video-Routing
Dieser Abschnitt kennt NUR Workflows der obersten Ebene. Er lädt keine workflow-internen Phasen, Domänenskills (hyperframes-* – siehe die Fähigkeitskarte oben) oder technische Referenzen.
Entscheidungstabelle
EINGABE-Typ (Absicht) ist die primäre Achse; AUSGABE-Länge ist nur eine Obergrenze, kein Tor. Für eine passende Eingabe behandeln die spezialisierten Workflows alles bis zu ~3 min – welcher Workflow betreten wird, entscheidet die Absicht (der Eingabetyp und bei Text das Thema), nicht die Länge. Die Länge spielt nur am oberen Ende eine Rolle: Ein wirklich langes Stück (ein 3-5 min Tutorial, eine 5 min+ Tiefenanalyse) ist eine andere Register und wird zu /general-video geleitet. Innerhalb des ≤~3 min Bandes teilt eine dritte Achse die beiden textgespeisten Workflows – das Thema: ein Produkt, das vermarktet wird vs. ein Thema, das erklärt wird (siehe die Disambiguierungsregel in Schritt 3 unten).
| Länge / Eingabe | Produkt-Launch (URL / Kurzbeschreibung / Skript) | Allgemeine Website / URL | GitHub-PR / Code-Änderung | Thema / Artikel / Notizen (kein Produkt, keine URL) | Vorhandenes Video (Talking-Head) † |
|---|---|---|---|---|---|
| ≤ ~3 min | /product-launch-video | /website-to-video | /pr-to-video | /faceless-explainer | /embedded-captions · /graphic-overlays † |
| 3-5min Tutorial | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| 5min+ Tiefenanalyse | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| Statisch / Schleife | /general-video | /general-video | /general-video | /general-video | /general-video |
Abdeckung heute: Das ≤ ~3 min Band hat dedizierte Workflows für Produkt-Launch / Allgemeine-Website / GitHub-PR / Thema-Eingaben (eine URL wird nach Art dann Absicht aufgeteilt – siehe Schritt 3), und die Spalte Vorhandenes Video wird bei jeder Länge abgedeckt – durch /embedded-captions (Untertitel) oder /graphic-overlays (gestaltete grafische Overlays), aufgeteilt nach Absicht (siehe Schritt 2). Jede andere Zelle ist /general-video – der allgemeine HTML-Kompositions-Authoring-Flow (eingabe- und längenunabhängig): alles länger als ~3 min (die 3-5 min / 5 min+ Zeilen) und jedes statische / Schleifen-Format. Der Router endet nie in einer Sackgasse bei einem erstellbaren Video; die einzig wahre „Allgemein / Keine“-Antwort ist eine Anfrage außerhalb von HyperFrames selbst (z.B. NLE-ähnliche Bearbeitung einer fertigen Videodatei – Neutiming, Neufärbung, neuer Bildausschnitt, Neuanordnung, Audio).
† Vorhandenes Filmmaterial wird nach Absicht aufgeteilt, nicht nach Länge. Untertitel → /embedded-captions; Gestaltete grafische Overlays / Verpackung – Lower Thirds, Datenhinweise, betitelte Karten, Pull-Quote – → /graphic-overlays. Beide überlagern den Clip, der unverändert darunter läuft; keines bearbeitet das Filmmaterial selbst.
Genre-Kurzschluss (geht der Tabelle voraus). Eine kurze (~unter 10s), unerzählte, designorientierte Motion Graphic – kinetische Typografie, ein Statistik-/ Diagramm-Treffer, ein Logo-Sting, ein Lower-Third / Overlay oder ein animierter Tweet / eine Schlagzeile / ein Highlight einer erfassten Seite – wird unabhängig von der Eingabe zu /motion-graphics geleitet. Es ist ein AUSGABE-Genre, kein Eingabetyp, daher hat es Vorrang vor der obigen Eingabetypen-Tabelle, wenn die Anfrage eindeutig bewegungsorientiert und ohne Erzählung ist (siehe Schritt 2). Eine längere oder erzählte Behandlung wird nach Eingabetyp oder /general-video geleitet.
Migration einer bestehenden Komposition (Spezialfall)
Die obige Tabelle dient dem Erstellen eines Videos aus einer Eingabe. Ein Workflow befindet sich außerhalb davon: Wenn der Benutzer explizit bittet, eine bestehende Remotion (React) Komposition zu portieren / konvertieren / migrieren → /remotion-to-hyperframes. Dies ist Quelltext-Übersetzung, keine Erstellung-aus-Eingabe, daher hat es keine EINGABE × LÄNGE Zelle. Leiten Sie hier NUR bei expliziter Migrationssprache weiter („portiere mein Remotion-Projekt“, „konvertiere diese Remotion-Komposition“, „schreibe dies als HyperFrames neu“) – eine beiläufige Erwähnung von Remotion ist kein Auslöser; verwenden Sie standardmäßig die Erstellungstabelle oder /hyperframes-core.
Routing-Verfahren
- EINGABE-Typ + Ziellänge bestimmen. Das Routing muss wissen, worum es in dem Video geht – sein Thema und seine Eingabe. Wenn das Thema selbst nicht spezifiziert ist (z.B. „mach ein Video über unser Ding“ ohne URL, benanntes Produkt, Thema oder Asset, mit dem gearbeitet werden kann), oder der Eingabetyp unbekannt ist, fragen Sie, bevor Sie einen Workflow betreten – klären Sie zuerst; rufen Sie keinen Workflow-Skill auf und fragen Sie dann, da das Betreten eines Workflows selbst die Routing-Entscheidung ist. Stellen Sie maximal 2 klärende Fragen:
- „Was ist Ihre Eingabe – ein Produkt (URL oder Kurzbeschreibung), eine allgemeine Website / URL, ein GitHub-PR / eine Code-Änderung, ein Thema oder Artikel zum Erklären, oder ein vorhandenes Talking-Head-Video zum Untertiteln?“
- „Ziëllänge – etwa 3 Minuten oder weniger, oder länger (ein 3-5 min Tutorial / 5 min+ Tiefenanalyse)?“
- Standardwerte der Spezifikation – benennen, nicht fragen (diese beeinflussen die Route NICHT, blockieren Sie also niemals das Routing damit): Seitenverhältnis 16:9 (die Engine unterstützt auch 9:16 vertikal – nur wechseln, wenn der Benutzer ein vertikales Ziel wie TikTok / Reels / Shorts nennt); Erzählungs-/Untertitel-Sprache = die des Benutzers. Bestätigen Sie nur, wenn der Benutzer widerspricht; der gewählte Workflow bestätigt seine eigenen Spezifikationen in seinem Schritt 0.
- Zuerst nach EINGABE-Typ (Absicht) wählen; Länge ist nur eine Obergrenze, kein Tor.
- Kurze designorientierte Motion Graphic (Genre-Kurzschluss, geht der Eingabetabelle voraus) – die Bewegung selbst ist die Botschaft: kinetische Typografie, ein Statistik-/Zahlen-Hochzählen, ein Diagramm-Treffer, ein Logo-Sting, ein Lower-Third / Overlay oder ein animierter Tweet / eine Schlagzeile / ein Highlight einer erfassten Seite; typischerweise unter ~10s, keine Erzählung / kein Voice-Over →
/motion-graphics. Dies ist ein AUSGABE-Genre, kein Eingabetyp – wenn die Anfrage eindeutig ein schnelles, unerzähltes, designorientiertes Bewegungsstück ist, leiten Sie hier unabhängig von der Eingabe weiter. Ein längeres oder erzähltes Stück desselben Materials ist NICHT dies (leiten Sie nach Eingabetyp oder/general-videoweiter). - Vorhandenes Talking-Head-Video (der Benutzer hat einen Clip und möchte etwas darüber legen) → nach Absicht aufteilen, bei jeder Länge (Eingabetyp gewinnt über Länge): Untertitel (die gesprochenen Wörter als lesbaren Text) →
/embedded-captions; gestaltete grafische Overlays – Lower Thirds, Datenhinweise, betitelte Info-Karten, Pull-Quote, eine grafisch verpackte Bearbeitung →/graphic-overlays. (Das Bearbeiten des Filmmaterials selbst – Neutiming, Neufärbung, neuer Bildausschnitt, Neuanordnung, Audio – ist NLE-ähnlich und nicht zulässig; siehe § Was HyperFrames nicht kann.) - GitHub-PR / Code-Änderung (ein
github.com/<owner>/<repo>/pull/<N>-Link, einowner/repo#N-Verweis oder „dieser PR“) →/pr-to-video(bis zu ~3 min). - Andernfalls (Produkt-URL / Kurzbeschreibung / Text): Die Absicht wählt den Workflow über Schritt 3, und dieser behandelt alles bis zu ~3 min – ein kurzer 15-30 s Promo und ein ~100 s Erklärvideo werden beide nach Absicht geleitet, nicht nach Länge. Leiten Sie zu
/general-video(den längenunabhängigen Fallback – siehe Schritt 4) nur, wenn das Ziel eindeutig länger als ~3 min ist (ein 3-5 min Tutorial, eine 5 min+ Tiefenanalyse). Zwingen Sie niemals ein wirklich langes Stück in einen ≤~3 min Workflow – die Absicht entscheidet innerhalb des Bandes,/general-videodeckt den Rest ab.
- Kurze designorientierte Motion Graphic (Genre-Kurzschluss, geht der Eingabetabelle voraus) – die Bewegung selbst ist die Botschaft: kinetische Typografie, ein Statistik-/Zahlen-Hochzählen, ein Diagramm-Treffer, ein Logo-Sting, ein Lower-Third / Overlay oder ein animierter Tweet / eine Schlagzeile / ein Highlight einer erfassten Seite; typischerweise unter ~10s, keine Erzählung / kein Voice-Over →
- Disambiguierung der ≤~3 min URL / Texteingaben (die Absichtsaufteilung). Zwei Aufteilungen:
- URL-Art + Absicht – eine URL gewinnt nicht mehr automatisch für PLV; ihre Art dann Absicht entscheidet: ein GitHub-PR-Link (
.../pull/<N>,owner/repo#N, „dieser PR“) →/pr-to-video; andernfalls wird eine Website-URL nach Absicht aufgeteilt – Marketing / Launch / Promotion eines bestimmten Produkts oder SaaS →/product-launch-video; eine allgemeine Site → Video (Site-Tour, Portfolio / Blog / Landing-Page-Showcase, ein Social-Clip von den eigenen Visuals der Site oder einfach „mach aus dieser Site ein Video“) →/website-to-video. Beide crawlen mit Headless Chrome; PR-URLs werden mitghgelesen. Wenn wirklich unklar ist, ob eine Site-URL ein Produkt-Launch oder ein allgemeines Site-Video ist, stellen Sie eine Frage. - Produkt vs. Thema (Text, keine URL) – die entscheidende Frage ist worum es in dem Video geht, nicht das Eingabeformat:
- Ein bestimmtes Produkt / Unternehmen / SaaS / App / Website, das vermarktet, gelauncht oder beworben wird →
/product-launch-video. - Ein Konzept / Thema / Artikel / Wie-etwas-funktioniert, das erklärt wird, mit keinem Produkt und keiner URL →
/faceless-explainer. - Tie-Breaker: „Bewerben / Launchen / Verkaufen / Unser Produkt“-Formulierung → PLV. „Erklären / Lehren / Wie X funktioniert / Was ist X“ ohne Produkt → faceless. Der gelieferte Stil für faceless ist immer
pin-and-paper. - Eine benannte Site ohne eingefügte URL ist immer noch PLV. Ein Skript, das ein Produkt oder seine Website erwähnt („unsere Site ist acme.io“, „bewerbe “), wird zu PLV geleitet, selbst wenn kein klickbarer Link vorhanden ist – PLV kann die Site im Web durchsuchen und nach Marken-Assets crawlen (es sei denn, der Benutzer lehnt ab → No-Capture-Preset-Modus). Das Nicht-Einfügen der URL macht es nicht zu einem faceless / No-Capture-Job. Die wörtliche-vs.-Umstrukturierungs-Wahl für ein geliefertes Skript ist intern in PLV und ändert niemals die Route.
- Widersprüchliche Hinweise → fragen, nicht raten. Wenn die gelieferte Quelle das eigene Marketing eines Produkts ist (seine Landing Page, ein Promo-Blog über ihre Plattform), der Benutzer aber explizit bittet, die Werbung zu entfernen – einen neutralen Erklärer des zugrunde liegenden Konzepts, keine Anzeige – behandeln Sie es als wirklich mehrdeutig (ist das Video…
- Ein bestimmtes Produkt / Unternehmen / SaaS / App / Website, das vermarktet, gelauncht oder beworben wird →
- URL-Art + Absicht – eine URL gewinnt nicht mehr automatisch für PLV; ihre Art dann Absicht entscheidet: ein GitHub-PR-Link (