HyperFrames – zuerst lesen
Hier starten für jede HyperFrames-Aufgabe – insbesondere, wenn keine Projekt-Agenten-Konfiguration (CLAUDE.md / AGENTS.md / .cursorrules) vorhanden ist. Fähigkeitenkarte + Video-Router unten.
Fähigkeitenkarte – welcher Skill für welche Absicht
| Sie möchten… | Gehen Sie zu |
|---|---|
| Ein Video erstellen (von einer URL, einer Anleitung, einem Thema, einem GitHub-PR, vorhandenem Filmmaterial oder einem einzelnen zu animierenden Element) | dem Video-Router unten (§ Video-Routing) |
Eine HTML-Komposition erstellen / bearbeiten – der 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, Voiceover, Beat-Planung, audio-reaktiv | /hyperframes-creative |
| Medien-Vorverarbeitung – TTS-Sprachausgabe, Hintergrundmusik, Transkription, Hintergrundentfernung, Untertitel | /hyperframes-media |
| CLI-Entwicklungsschleife – init, lint, validieren, inspizieren, Vorschau, rendern, veröffentlichen, reparieren | /hyperframes-cli |
Registry-Blöcke / Komponenten installieren (hyperframes add) | /hyperframes-registry |
Der Autorisierungsvertrag für Kompositionen (jedes zeitgesteuerte Element benötigt
data-start/data-duration/data-track-index; zeitgesteuerte Elemente benötigenclass="clip"; GSAP-Timelines sind pausiert und aufwindow.__timelinesregistriert; nur deterministische Logik – keinDate.now()/Math.random()/ Netzwerk) wird hier nicht wiederholt – er befindet sich in/hyperframes-core. Lesen Sie diesen, bevor Sie Kompositions-HTML schreiben.
Was HyperFrames nicht kann – zuerst prüfen
HyperFrames erstellt eine HTML-Komposition und rendert sie aus Code in MP4. Dieses Modell hat harte äußere Grenzen. Eine Anfrage, die eine davon überschreitet, ist keine Routing-Entscheidung – sie ist außerhalb des Rahmens, also lehnen Sie ab (oder verweisen Sie auf das richtige Tool), anstatt einen Workflow zu suchen. Diese folgen aus der Architektur, nicht aus einer einzelnen Anfrage:
- Der Render ist deterministisch und in sich geschlossen. Jeder Wert, jedes Asset und jeder Text wird beim Erstellen eingebrannt; der Render führt keinen Netzwerkaufruf und keinen Live-Datenabruf zur Renderzeit durch (Grundregel: kein
Date.now()/Math.random()/ Netzwerk). „Die Zahlen zur Renderzeit live aktualisieren“ ist nicht möglich – holen Sie die Daten einmal zur Erstellungszeit ab und brennen Sie sie ein, oder lehnen Sie ab. - Vorhandenes Video wird überlagert, niemals bearbeitet. HyperFrames setzt Bilder über einen Quellclip –
/embedded-captionsfügt eine Untertitelebene hinzu,/graphic-overlaysfügt gestaltete Grafikkarten (Lower Thirds, Datenausrufe, Titel) hinzu – und der Clip läuft unverändert darunter, aber keiner von beiden bearbeitet den codierten Videostream nachträglich. Das Filmmaterial selbst zu verändern (seine Zeitsteuerung, Farbe, Bildausschnitt, Reihenfolge oder Audio) ist NLE-Bearbeitung und außerhalb des Rahmens. - Remotion-Import ist unidirektional.
/remotion-to-hyperframesübersetzt die Remotion-Framework-Quelle in HyperFrames. Es gibt keine Rückwärtsrichtung (HyperFrames → Remotion oder → ein anderes Framework – außerhalb des Rahmens), und eine Nicht-Remotion-React-/Web-Animation-Quelle hat keine Remotion-Quelle zu übersetzen – erstellen Sie sie über/general-videoneu. - Es kann keine Eingaben erzeugen, die es nicht hat. Keine Bildschirm-/Sitzungsaufzeichnung, keine Kameraaufnahme, keine KI-generierte Sprechkopf-/Lippensynchronisations-Avatarerzeugung. 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).
Alles andere – ein Video von einer URL, einem Thema, einem PR, Filmmaterial zum Annotieren oder einem einzelnen zu animierenden Element – ist im Rahmen; leiten Sie es unten weiter.
Video-Routing
Dieser Abschnitt kennt NUR Workflows der obersten Ebene. Er lädt keine Workflow-internen Phasen, Domain-Skills (hyperframes-* – siehe die Fähigkeitenkarte oben) oder technische Referenzen.
Entscheidungstabelle
Der Eingabetyp (Absicht) ist die primäre Achse; die Ausgabelänge ist nur eine Obergrenze, kein Tor. Bei einer passenden Eingabe erledigen die spezialisierten Workflows alles bis ca. 3 min – welcher Workflow betreten wird, entscheidet sich durch die Absicht (den Eingabetyp und bei Text das Thema), nicht durch die Länge. Die Länge zählt nur am oberen Ende: Ein wirklich längerer Beitrag (ein 3-5-minütiges Tutorial, ein 5 min+ tiefergehender Einblick) ist eine andere Registerebene und wird zu /general-video weitergeleitet. Innerhalb des ≤~3-min-Bandes teilt eine dritte Achse die beiden textbasierten 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 / Anleitung / Drehbuch) | Allgemeine Website / URL | GitHub-PR / Code-Änderung | Thema / Artikel / Notizen (kein Produkt, keine URL) | Vorhandenes Video (Sprecherkopf) † |
|---|---|---|---|---|---|
| ≤ ~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+ Deep Dive | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| Statisch / Loop | /general-video | /general-video | /general-video | /general-video | /general-video |
Abdeckung heute: Die ≤~3-min-Bandbreite hat dedizierte Workflows für Produkt-Launch / allgemeine-Website / GitHub-PR / Themen-Eingaben (eine URL teilt sich nach Art dann Absicht – siehe Schritt 3), und die Spalte vorhandenes Video ist für jede Länge abgedeckt – durch /embedded-captions (Untertitel / Untertitel) oder /graphic-overlays (gestaltete Grafik-Overlays), aufgeteilt nach Absicht (siehe Schritt 2). Jede andere Zelle ist /general-video – der allgemeine HTML-Kompositions-Erstellungsfluss (eingabe- und längenunabhängig): alles länger als ~3 min (die Zeilen 3-5 min / 5 min+) und jedes statische / Loop-Format. Der Router endet nie in einer Sackgasse für ein erstellbares Video; die einzige wirkliche „Allgemein / Keine“-Antwort ist eine Anfrage außerhalb von HyperFrames selbst (z. B. NLE-Bearbeitung eines fertigen Videodatei – Neuzuschneiden, Umfärben, Neurahmen, Neuordnen, Audio).
† Vorhandenes Filmmaterial teilt sich nach Absicht, nicht nach Länge. Untertitel / Untertitel → /embedded-captions; gestaltete Grafik-Overlays / Verpackung – Lower Thirds, Datenausrufe, beschriftete Karten, Zitate – → /graphic-overlays. Beide überlagern den Clip, der unverändert darunter abgespielt wird; keiner bearbeitet das Filmmaterial selbst.
Genre-Kurzschluss (geht der Tabelle voraus). Ein kurzer (ca. unter 10s), unkommentierter, designorientierter Bewegtgrafik – kinetischer Text, ein Statistik-/Chart-Hit, ein Logo-Sting, ein Lower-Third / Overlay oder ein animierter Tweet / eine Schlagzeile / ein eingefangener Seiten-Highlight – wird zu /motion-graphics weitergeleitet, unabhängig von der Eingabe. Es ist ein AUSGABE-Genre, kein Eingabetyp, also hat es Vorrang vor der Eingabetyp-Tabelle oben, wenn die Anfrage eindeutig bewegungsorientiert und ohne Kommentar ist (siehe Schritt 2). Eine längere oder kommentierte Behandlung wird nach Eingabeart oder /general-video weitergeleitet.
Migration einer bestehenden Komposition (Sonderfall)
Die Tabelle oben gilt für das Erstellen eines Videos aus einer Eingabe. Ein Workflow liegt außerhalb davon: Wenn der Benutzer explizit darum bittet, eine bestehende Remotion (React)-Komposition in HyperFrames zu portieren / konvertieren / migrieren → /remotion-to-hyperframes. Dies ist Quellübersetzung, keine Erstellung aus einer Eingabe, daher hat es keine EINGABE × LÄNGE-Zelle. Leiten Sie hier NUR auf explizite Migrationssprache weiter („portiere mein Remotion-Projekt“, „konvertiere diese Remotion-Komposition“, „schreibe dies als HyperFrames um“) – eine beiläufige Erwähnung von Remotion ist kein Auslöser; standardmäßig zur Erstellungstabelle oder /hyperframes-core gehen.
Routing-Verfahren
- EINGABE-Typ + Ziellänge bestimmen. Das Routing muss wissen, worum es im Video geht – sein Thema und seine Eingabe. Wenn das Thema selbst nicht spezifiziert ist (z. B. „Erstelle ein Video über unser Ding“ ohne URL, genanntes Produkt, Thema oder zu verwendendes Asset) oder der Eingabetyp unbekannt ist, vor dem Betreten eines Workflows fragen – zuerst klären; keinen Workflow-Skill aufrufen und dann fragen, da das Betreten eines Workflows selbst die Routing-Entscheidung ist. Maximal 2 klärende Fragen stellen:
- „Was ist Ihre Eingabe – ein Produkt (URL oder kurze Beschreibung), eine allgemeine Website / URL, ein GitHub-PR / eine Code-Änderung, ein zu erklärendes Thema oder ein Artikel oder ein vorhandenes Sprecherkopf-Video zum Untertiteln?“
- „Ziellänge – etwa 3 Minuten oder weniger, oder länger (ein 3-5-minütiges Tutorial / 5 min+ tiefergehender Einblick)?“
- Spezifikationsstandards – nennen, nicht fragen (diese beeinflussen die Route NICHT, also blockieren Sie das Routing nie 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); Sprachausgabe / Untertitel- Sprache = die des Benutzers. Nur bestätigen, wenn der Benutzer widerspricht; der gewählte Workflow bestätigt seine eigenen Spezifika in Schritt 0.
- Primär nach EINGABE-Typ (Absicht) wählen; Länge ist nur eine Obergrenze, kein Tor.
- Kurzer, designorientierter Bewegtgrafik (Genre-Kurzschluss, geht der Eingabentabelle voraus) – die Bewegung selbst ist die Botschaft: kinetischer Text, ein Statistik-/Zahlen-Hochzähler, ein Chart-Hit, ein Logo-Sting, ein Lower-Third / Overlay oder ein animierter Tweet / eine Schlagzeile / ein eingefangener Seiten-Highlight; typischerweise unter ~10s, kein Kommentar / Voice-Over →
/motion-graphics. Dies ist ein AUSGABE-Genre, kein Eingabetyp – wenn die Anfrage eindeutig ein kurzes, unkommentiertes, designorientiertes Bewegungsstück ist, leiten Sie hier unabhängig von der Eingabe weiter. Eine längere oder kommentierte Behandlung desselben Materials ist NICHT dies (nach Eingabetyp oder/general-videoweiterleiten). - Vorhandenes Sprecherkopf-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 / Untertitel (die gesprochenen Wörter als lesbarer Text) →
/embedded-captions; gestaltete Grafik-Overlays – Lower Thirds, Datenausrufe, beschriftete Info-Karten, Zitate, ein grafikverpackter Schnitt →/graphic-overlays. (Das Filmmaterial selbst zu bearbeiten – Neuzuschneiden, Umfärben, Neurahmen, Neuordnen, Audio – ist NLE-Stil und außerhalb des Rahmens; 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 ~3 min). - Andernfalls (Produkt-URL / Anleitung / Thema-Text): Die Absicht wählt den Workflow über Schritt 3, und er behandelt alles bis ~3 min – ein kurzer 15-30 s Promo und ein ~100 s Erklärvideo werden beide nach Absicht weitergeleitet, nicht nach Länge. Leiten Sie zu
/general-video(dem längenunabhängigen Fallback – siehe Schritt 4) nur weiter, wenn das Ziel eindeutig länger als ~3 min ist (ein 3-5-minütiges Tutorial, ein 5 min+ tiefergehender Einblick). Erzwingen Sie niemals ein wirklich langes Stück in einen ≤~3-min-Workflow – die Absicht entscheidet innerhalb der Bandbreite,/general-videodeckt den Rest ab.
- Kurzer, designorientierter Bewegtgrafik (Genre-Kurzschluss, geht der Eingabentabelle voraus) – die Bewegung selbst ist die Botschaft: kinetischer Text, ein Statistik-/Zahlen-Hochzähler, ein Chart-Hit, ein Logo-Sting, ein Lower-Third / Overlay oder ein animierter Tweet / eine Schlagzeile / ein eingefangener Seiten-Highlight; typischerweise unter ~10s, kein Kommentar / Voice-Over →
- Die ≤ ~3 min URL / Text-Eingaben disambiguieren (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 teilt sich eine Website-URL nach Absicht – Marketing / Einführen / Bewerben eines bestimmten Produkts oder SaaS →/product-launch-video; eine allgemeine Website → Video (Site-Tour, Portfolio / Blog / Landing-Page-Showcase, ein Social-Clip aus den eigenen Visuals der Site oder einfach „mach diese Site zu einem Video“) →/website-to-video. Beide crawlen mit headless Chrome; PR-URLs werden überghgelesen. 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 im Video geht, nicht das Eingabeformat:
- Ein spezifisches Produkt / Unternehmen / SaaS / App / Website, das vermarktet, eingeführt oder beworben wird →
/product-launch-video. - Ein Konzept / Thema / Artikel / Wie-etwas-funktioniert, das erklärt wird, ohne Produkt und ohne URL →
/faceless-explainer. - Entscheider: „Bewerben / Einführen / Verkaufen / unser Produkt“-Formulierung → PLV. „Erklären / Lehren / Wie X funktioniert / Was ist X“ ohne Produkt → Faceless. Der ausgelieferte Stil für Faceless ist immer
pin-and-paper. - Eine genannte Seite ohne eingefügte URL ist dennoch PLV. Ein Skript, das ein Produkt oder seine Website erwähnt („unsere Seite ist acme.io“, „bewerbe “), leitet zu PLV weiter, selbst ohne anklickbaren Link – PLV kann die Site im Web durchsuchen und sie nach Marken-Assets crawlen (es sei denn, der Benutzer widerspricht → Modus ohne Aufnahme). Das Nicht-Einfügen der URL macht es nicht zu einem Faceless / Ohne-Aufnahme-Auftrag. Die Wahl zwischen wörtlicher vs. umstrukturierter Wiedergabe für ein bereitgestelltes Skript ist intern in PLV und ändert niemals die Route.
- Widersprüchliche Hinweise → fragen, nicht raten. Wenn die bereitgestellte Quelle das eigene Marketing eines Produkts ist (seine Landing Page, ein Promo-Blog über ihre Plattform), aber der Benutzer explizit darum bittet, die Werbung zu entfernen – einen neutralen Erklärer des zugrunde liegenden Konzepts, keine Anzeige – behandeln Sie dies als wirklich mehrdeutig (ist das Video ein …
- Ein spezifisches Produkt / Unternehmen / SaaS / App / Website, das vermarktet, eingeführt oder beworben wird →
- URL-Art + Absicht – eine URL gewinnt nicht mehr automatisch für PLV; ihre Art dann Absicht entscheidet: ein GitHub-PR-Link (