HyperFrames – zuerst lesen
Hier starten für jede HyperFrames-Aufgabe – insbesondere, wenn keine Projekt-Agentenkonfiguration (CLAUDE.md / AGENTS.md / .cursorrules) vorhanden ist. Fähigkeitskarte + Video-Router unten.
Fähigkeitskarte – welche Fähigkeit für welchen Intent
| Sie möchten… | Gehen Sie zu |
|---|---|
| Ein Video erstellen (aus URL, Kurzbeschreibung, Thema, GitHub PR, vorhandenem Material oder einem einzelnen zu animierenden Element) | Router unten (§ Video-Routing) |
Eine HTML-Komposition verfassen / bearbeiten – der data-*-Vertrag, Clips, Tracks, 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, Beat-Planung, audio-reaktiv | /hyperframes-creative |
| Medien-Vorverarbeitung – TTS-Sprachausgabe, Hintergrundmusik, Transkription, Hintergrundentfernung, Untertitel | /hyperframes-media |
| CLI-Entwicklungszyklus – init, lint, validate, inspect, preview, render, publish, 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 unterwindow.__timelinesregistriert; nur deterministische Logik – keinDate.now()/Math.random()/ Netzwerk) wird hier nicht dupliziert – er befindet sich in/hyperframes-core. Lesen Sie dies, 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 liegt außerhalb des Geltungsbereichs, lehnen Sie sie also 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 fest eingebaut; der Render-Vorgang führt keinen Netzwerkaufruf und keinen Live-Datenabruf zum Renderzeitpunkt durch (Grundregel: kein
Date.now()/Math.random()/ Netzwerk). „Zahlen live zum Renderzeitpunkt aktualisieren“ ist nicht möglich – rufen Sie die Daten einmal zum Authoring-Zeitpunkt ab und bauen Sie sie ein, oder lehnen Sie ab. - Vorhandenes Video wird überlagert, nie bearbeitet. HyperFrames komponiert Frames über einem Quellclip –
/embedded-captionsfügt eine Untertitelebene hinzu,/graphic-overlaysfügt gestaltete Grafikkarten (Lower-Thirds, Daten-Einblendungen, Titel) hinzu – und der Clip läuft unverändert darunter, aber keins von beiden verarbeitet den codierten Videostream nach. Die Veränderung des Footage selbst (seine Zeitsteuerung, Farbe, Bildausschnitt, Reihenfolge oder Audio) ist NLE-ähnliche Bearbeitung und liegt außerhalb des Geltungsbereichs. - Remotion-Import ist unidirektional.
/remotion-to-hyperframesübersetzt den Quellcode des Remotion-Frameworks in HyperFrames. Es gibt keinen umgekehrten Weg (HyperFrames → Remotion oder → ein anderes Framework – außerhalb des Geltungsbereichs), und eine Nicht-Remotion-React-/Web-Animation-Quelle hat keine Remotion-Quelle zum Übersetzen – erstellen Sie sie neu über/general-video. - Es kann keine Eingaben erzeugen, die es nicht hat. Keine Bildschirm-/Sitzungsaufnahme, keine Kameracapture, keine KI-Erstellung eines sprechenden Kopfes / Lippensynchronisation. Wenn das Footage 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 aus einer URL, einer Kurzbeschreibung, einem Thema, einem PR, Footage zur Annotation oder ein einzelnes zu animierendes Element – liegt im Geltungsbereich; routen Sie es unten.
Video-Routing
Dieser Abschnitt kennt NUR Workflows der obersten Ebene. Er lädt keine workflow-internen Phasen, Domain-Fähigkeiten (hyperframes-* – siehe die Fähigkeitskarte oben) oder technische Referenzen.
Entscheidungstabelle
Der EINGABETYP (Intent) ist die primäre Achse; die AUSGABELÄNGE ist nur eine Obergrenze, kein Tor. Bei einer passenden Eingabe behandeln die spezialisierten Workflows alles bis zu ~3 Minuten – welchen Workflow Sie betreten, wird durch den Intent (den Eingabetyp und bei Text das Thema) entschieden, nicht durch die Länge. Die Länge spielt nur am oberen Ende eine Rolle: ein wirklich längerer Beitrag (ein 3-5-minütiges Tutorial, eine 5-min+-Tiefenanalyse) ist ein anderer Register und wird zu /general-video geroutet. Innerhalb des ≤~3-Minuten-Bandes teilt eine dritte Achse die beiden Text-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 | Produkteinführung (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-5-Min-Tutorial | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| 5 Min+ Tiefenanalyse | /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: das ≤ ~3 Min-Band hat dedizierte Workflows für Produkteinführung / allgemeine Website / GitHub-PR / Thema-Eingaben (eine URL wird nach Art dann Intent 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 Intent (siehe Schritt 2). Jede andere Zelle ist /general-video – der allgemeine HTML-Kompositions-Workflow (eingabe- und längenunabhängig): alles länger als ~3 Minuten (die 3-5-Min/5-Min+-Zeilen) und jedes statische / Loop-Format. Der Router endet nie bei einem erstellbaren Video in einer Sackgasse; die einzige echte „allgemein/keine“ Antwort ist eine Anfrage außerhalb von HyperFrames selbst (z. B. NLE-ähnliche Bearbeitung einer fertigen Videodatei – Neutiming, Neufärbung, Neubildausschnitt, Neuordnung, Audio).
† Vorhandenes Footage wird nach Intent aufgeteilt, nicht nach Länge. Untertitel → /embedded-captions; gestaltete grafische Overlays / Verpackung – Lower-Thirds, Daten-Einblendungen, Titelcards, Pull-Quotes – → /graphic-overlays. Beide überlagern den Clip, der unverändert darunter läuft; keins bearbeitet das Footage selbst.
Genre-Kurzschluss (geht der Tabelle voraus). Eine kurze (~unter 10s), unerzählte, designgeführte Bewegungsgrafik – kinetischer Text, ein Statistik-/Chart-Treffer, ein Logo-Sting, ein Lower-Third/Overlay oder eine animierte Tweet-/Schlagzeile-/erfasste-Seite-Hervorhebung – wird zu /motion-graphics geroutet, unabhängig von der Eingabe. Es ist ein AUSGABEGenre, kein Eingabetyp, therefore hat es Vorrang vor der obigen Eingabetabelle, wenn die Anfrage eindeutig bewegungsgesteuert und ohne Erzählung ist (siehe Schritt 2). Eine längere oder erzählte Behandlung wird nach Eingabetyp oder /general-video geroutet.
Migration einer bestehenden Komposition (Spezialfall)
Die obige Tabelle gilt für das Erstellen eines Videos aus einer Eingabe. Ein Workflow liegt außerhalb: wenn der Benutzer explizit darum bittet, eine bestehende Remotion (React) Komposition nach HyperFrames zu portieren/konvertieren/migrieren → /remotion-to-hyperframes. Dies ist Quellcode-Übersetzung, nicht Erstellen-aus-Eingabe, daher hat es keine EINGABE × LÄNGE-Zelle. Routen Sie hier NUR bei expliziter Migrationssprache („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.
Routing-Verfahren
- EINGABETYP + 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 vor dem Betreten eines Workflows – klären Sie zuerst; rufen Sie keine Workflow-Fähigkeit auf und fragen Sie dann, da das Festlegen auf einen Workflow 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 / Code-Änderung, ein zu erklärendes Thema oder Artikel, oder ein vorhandenes Talking-Head-Video zum Untertiteln?“
- „Ziellänge – etwa 3 Minuten oder kürzer, oder länger (ein 3-5-Min-Tutorial / 5-Min+-Tiefenanalyse)?“
- Standardwerte – benennen, nicht fragen (diese beeinflussen die Route NICHT, daher blockieren Sie das Routing nie damit): Seitenverhältnis 16:9 (die Engine unterstützt auch 9:16 vertikal – wechseln Sie nur, 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 Einwände erhebt; der gewählte Workflow bestätigt seine eigenen Spezifika in Schritt 0.
- Wählen Sie zuerst nach EINGABETYP (Intent); Länge ist nur eine Obergrenze, kein Tor.
- Kurze designgeführte Bewegungsgrafik (Genre-Kurzschluss, geht der Eingabetabelle voraus) – die Bewegung selbst ist die Botschaft: kinetischer Text, ein Statistik-/Zahlen-Count-up, ein Chart-Treffer, ein Logo-Sting, ein Lower-Third/Overlay oder eine animierte Tweet-/Schlagzeile-/erfasste-Seite-Hervorhebung; typischerweise unter ~10s, keine Erzählung / Sprachausgabe →
/motion-graphics. Dies ist ein AUSGABEGenre, kein Eingabetyp – wenn die Anfrage eindeutig ein schnelles, unerzähltes, designgeführtes Bewegungsstück ist, routen Sie hier unabhängig von der Eingabe. Eine längere oder erzählte Behandlung desselben Materials ist NICHT dies (nach Eingabetyp routen oder/general-video). - Vorhandenes Talking-Head-Video (der Benutzer hat einen Clip und möchte etwas darüber legen) → nach Intent aufteilen, bei jeder Länge (Eingabetyp gewinnt über Länge): Untertitel (die gesprochenen Worte als lesbarer Text) →
/embedded-captions; gestaltete grafische Overlays – Lower-Thirds, Daten-Einblendungen, betitelte Infokarten, Pull-Quotes, eine grafikverpackte Bearbeitung →/graphic-overlays. (Das Bearbeiten des Footage selbst – Neutiming, Neufärbung, Neubildausschnitt, Neuordnung, Audio – ist NLE-ähnlich und außerhalb des Geltungsbereichs; siehe § Was HyperFrames nicht kann.) - GitHub PR / Code-Änderung (ein
github.com/<owner>/<repo>/pull/<N>-Link, eineowner/repo#N-Referenz oder „dieser PR“) →/pr-to-video(bis zu ~3 Min). - Andernfalls (Produkt-URL / Kurzbeschreibung / Thema-Text): der Intent wählt den Workflow über Schritt 3, und er behandelt alles bis zu ~3 Minuten – ein kurzer 15-30-s-Promo und ein ~100-s-Erklärvideo werden beide nach Intent geroutet, nicht nach Länge. Routen Sie zu
/general-video(den längenunabhängigen Fallback – siehe Schritt 4) nur, wenn das Ziel eindeutig länger als ~3 Minuten ist (ein 3-5-Min-Tutorial, eine 5-Min+-Tiefenanalyse). Erzwingen Sie niemals, dass ein wirklich langes Stück in einen ≤~3-Min-Workflow passt – der Intent entscheidet innerhalb des Bandes,/general-videodeckt den Rest ab.
- Kurze designgeführte Bewegungsgrafik (Genre-Kurzschluss, geht der Eingabetabelle voraus) – die Bewegung selbst ist die Botschaft: kinetischer Text, ein Statistik-/Zahlen-Count-up, ein Chart-Treffer, ein Logo-Sting, ein Lower-Third/Overlay oder eine animierte Tweet-/Schlagzeile-/erfasste-Seite-Hervorhebung; typischerweise unter ~10s, keine Erzählung / Sprachausgabe →
- Disambiguieren der ≤~3 Min URL / Texteingaben (Intent-Split). Zwei Splits:
- URL-Art + Intent – eine URL gewinnt nicht mehr automatisch für PLV; ihre Art dann Intent entscheidet: ein GitHub PR-Link (
.../pull/<N>,owner/repo#N, „dieser PR“) →/pr-to-video; andernfalls wird eine Website-URL nach Intent aufgeteilt – Vermarktung / Einführung / Bewerbung eines bestimmten Produkts oder SaaS →/product-launch-video; eine allgemeine Seite → Video (Site-Tour, Portfolio/Blog/Landingpage-Showcase, ein Social-Clip aus den eigenen visuellen Elementen der Seite, oder einfach „mach aus dieser Site ein Video“) →/website-to-video. Beide crawlen mit Headless Chrome; PR-URLs sind...
- URL-Art + Intent – eine URL gewinnt nicht mehr automatisch für PLV; ihre Art dann Intent entscheidet: ein GitHub PR-Link (