general-video — allgemeiner Video-Workflow
Bestätigen Sie den Weg, bevor Sie bauen. Dies ist der Fallback für die Erstellung benutzerdefinierter Kompositionen. Wenn die Eingabe eindeutig zu einem spezialisierten Workflow passt, bevorzugen Sie diesen: Themen-Erklärung →
/faceless-explainer; GitHub-PR →/pr-to-video; vorhandenes Filmmaterial →/embedded-captions·/talking-head-recut; kurze unkommentierte Bewegungsgrafik →/motion-graphics. Nicht im Scope: Live- / Renderzeit-Daten, NLE-ähnliche Bearbeitung eines fertigen Videos oder die Produktion von Filmmaterial, das HyperFrames nicht erfassen kann. Unsicher? Lesen Sie/hyperframeszuerst.
Bauen Sie genau das, was verlangt wurde. Eine Titelcard ist eine Titelcard — keine Titelcard + drei unterstützende Szenen + Untertitel. Wenn zusätzliche Szenen oder Elemente das Stück tatsächlich verbessern würden, schlagen Sie sie vor; fügen Sie sie nicht stillschweigend hinzu. Bei kleinen Änderungen (eine Farbe korrigieren, eine Dauer anpassen, ein Element hinzufügen) überspringen Sie die Planungsschritte und gehen Sie direkt zum Bau.
Vorgehen
Discovery — nur bei offenen Anfragen
Bei vagen, explorativen Anfragen („Mach etwas für unsere Marke“, „einen coolen Intro“) — verstehen Sie die Absicht, bevor Sie Farben wählen:
- Zielgruppe — wer schaut zu? Entwickler / Führungskräfte / allgemeine Verbraucher?
- Plattform — wo wird es abgespielt? Social (15s) / Website-Hero / Produkt-Demo / intern?
- Priorität — was ist am wichtigsten? Bewegungsqualität / Inhaltsgenauigkeit / Markentreue / Geschwindigkeit?
- Varianten — ein bester Versuch oder 2-3 sinnvoll unterschiedliche Optionen (unterschiedliches Tempo, Energie oder Struktur — nicht nur Farbwechsel)?
Bei spezifischen Anfragen („Füge eine Titelcard hinzu“, „Korrigiere das Timing in Szene 3“) überspringen Sie die Discovery.
Schritt 1 — Designsystem → hyperframes-design
Legen Sie zuerst die visuelle Identität fest. Wenn das Projekt ein Design-Spezifikation hat, lesen Sie es (Priorität frame.md → design.md → DESIGN.md; behandeln Sie es als Markenwahrheit — exakte Farben, Schriften, Einschränkungen).
Wenn keine Spezifikation existiert, MÜSSEN Sie SOWOHL hyperframes-design/references/house-style.md ALS AUCH hyperframes-design/references/video-composition.md lesen, bevor Sie eine Farbe oder Schrift wählen. house-style.md liefert den „Prompt interpretieren / echten Inhalt generieren“-Einstieg, die Lazy-Default-Liste und das Layer-Rezept; video-composition.md liefert die Video-Medium-Dichte / -Skala / Vordergrund-Detaillierung (Datenbalken, Registrierungsmarken, Monospace-Metadaten, „8-10 Elemente, von denen zwei der Benutzer nicht verlangt hat“), die „produziert“ von „generiert“ trennt. Nur eines zu lesen ist der häufigste Fehler — video-composition.md ist das, was Agenten überspringen, und genau das verhindert flache, zentrierte, webseitenartige Ausgabe. Erfinden Sie keine eigene Palette und überspringen Sie diese nicht; der Einstieg in hyperframes-design ist hier obligatorisch, kein optionaler Zweig. Ziehen Sie bei Bedarf auch einen benannten Stil / eine Stimmung → references/visual-styles.md. Die Spezifikation / der Stil definiert die Marke, nicht die Kompositionsregeln.
Finden Sie den Winkel (vage Vorgabe, keine Spezifikation): Schreiben Sie, bevor Sie Farben wählen, EINEN Satz — was evoziert dieser Name/dieses Wort/dieses Thema, und welche visuelle Welt (Metapher, Setting, Instrument, Motiv) drückt es aus? Z. B. ein Cybersicherheitstool → Tresortüren / Perimeter-Scan-Linien / Schlossfallen; eine Meditations-App → Gezeiten, Atem, sanfte Lichtblüte. Lesen Sie die Bedeutung des Subjekts, nicht nur seine Buchstaben; wählen Sie einen konkreten Winkel statt einer wörtlichen Neugestaltung. Dies ist der günstige Ersatz für die Prompt-Erweiterung (Schritt 2) bei Ein-Szene-Stücken, bei denen die Erweiterung zu Recht übersprungen wird — und es ist der Unterschied zwischen einem gestalteten Konzept und einem generischen Logo auf einem Farbverlauf.
Schritt 2 — Prompt-Erweiterung → hyperframes-design
Führen Sie dies für jede mehrszenige Komposition durch (überspringen Sie es bei Ein-Szene-Stücken und trivialen Bearbeitungen). Verankern Sie die Anfrage gegen die Design-Spezifikation + Hausstil in einem konsistenten Zwischenprodukt, das die nachgelagerte Arbeit auf die gleiche Weise liest. Siehe hyperframes-design/references/prompt-expansion.md.
Schritt 3 — Plan
Denken Sie auf hohem Niveau, bevor Sie HTML schreiben:
- Was — das Zuschauererlebnis: Erzählbogen, Schlüsselmomente, emotionale Schläge.
- Struktur — wie viele Kompositionen, Sub-Comp vs. Inline, welche Tracks tragen Video / Overlays / Untertitel. Für den monolithischen-Einzeldatei- vs. modularer-Sub-Comp-Entscheid siehe
/hyperframes/core/references/composition-patterns.md§ Zwei Architekturen (Faustregel: ≥3 harte Szenenschnitte oder jede wiederverwendete Szene → modularisieren; ein kurzes Ein-Szene-Stück bleibt eine Datei). - Rhythmus — benennen Sie das Muster, bevor Sie es implementieren (z. B.
schnell-schnell-LANGSAM-SHADER-halten); siehehyperframes-design/references/beat-direction.md. - Timing — welche Clips treiben die Dauer, wo landen Übergänge, das Tempo.
- Layout — bauen Sie zuerst den Endzustand (siehe unten).
- Animieren — fügen Sie dann Bewegung über
hyperframes-motionhinzu.
Layout vor Animation
Positionieren Sie jedes Element dort, wo es in seinem sichtbarsten Moment sitzt — vollständig eingetreten, korrekt platziert, noch nicht austretend. Schreiben Sie das zuerst als statisches HTML + CSS. Noch kein GSAP.
Warum: Wenn Sie Elemente in ihrem animierten Startzustand positionieren (außerhalb des Bildschirms, skaliert auf 0, Deckkraft 0) und zu der Stelle tweenen, von der Sie denken, dass sie landen, raten Sie das endgültige Layout — Überlappungen bleiben bis zum Rendern unsichtbar. Bauen Sie zuerst den Endzustand, und Sie sehen und beheben Layout-Probleme, bevor Sie Bewegung hinzufügen.
- Identifizieren Sie den Helden-Frame für jede Szene — den Moment, in dem die meisten Elemente gleichzeitig sichtbar sind. Das ist das Layout, das Sie bauen.
- Schreiben Sie statisches CSS für diesen Frame. Der Inhaltscontainer muss die Szene mit Padding füllen, nicht mit absoluten Offsets:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* Padding positioniert den Inhalt; füllt jede Szenengröße */
gap: 24px;
box-sizing: border-box;
}
Verwenden Sie niemals position: absolute; top: Npx auf einem Inhaltscontainer — er läuft über, wenn der Inhalt höher als der Raum ist. Reservieren Sie absolute Positionierung für Dekorationen.
⚠ Die
width/height: 100%oben funktioniert nur, wenn jeder Vorfahre eine aufgelöste Höhe hat. Das Wurzel-<div data-composition-id>und jeder Wrapper zwischen ihm und.scene-contentmuss dimensioniert sein (position: relative; width: 1920px; height: 1080pxauf der Wurzel — siehe/hyperframes/core→ „Root must be sized“). Überspringen Sie dies und der Flex-Container kollabiert auf ~0, der Inhalt stapelt sich in der oberen linken Ecke, und das erste Glyph wird bei x=0 abgeschnitten — währendlint/inspectimmer noch 0 Probleme melden. Und behalten Sie immer daspadding(≥80px) auf.scene-contentbei: es ist der titelsichere Rand. Ersetzen Sie es niemals durch bloßesgap.
- Fügen Sie Eintritte hinzu — animieren Sie VON außerhalb des Bildschirms / unsichtbar ZU der CSS-Position mit
gsap.from()(bevorzugen Sie in Sub-Kompositionengsap.fromTo(), damit der Startzustand explizit ist; siehe/hyperframes/core/references/sub-compositions.md). Die CSS-Position ist die Grundwahrheit; der Tween ist die Reise dorthin. - Austritte werden durch Übergänge behandelt — gemäß den Szenenübergangsregeln in
hyperframes-motion/transitions/animiert nur die letzte Szene Elemente aus; zwischen Szenen IST der Übergang der Austritt.
Geteilter Raum über die Zeit: Wenn Element A austritt, bevor Element B im selben Bereich eintritt, benötigen beide dennoch korrekte CSS-Positionen für ihre jeweiligen Helden-Frames — die Timeline-Reihenfolge verhindert, dass sie koexistieren, und der Layout-Schritt fängt versehentliche Überlappungen auf. Geschichtete Glühen/Schatten und z-gestaffelte Tiefe sind beabsichtigte Überlappung; der Schritt dient dazu, unbeabsichtigte Kollisionen zu erkennen (zwei Überschriften übereinander, Inhalt, der aus dem Frame läuft).
Bauen — an die Domänen-Skills delegieren
Dies bildet die vollständige Oberfläche des Skills (siehe die description) auf seine Referenzen ab — nicht erschöpfend; wenn eine Absicht nicht aufgeführt ist, leiten Sie über hyperframes-design (Look/Konzept), hyperframes-motion (Bewegung), /hyperframes/core (Vertrag) weiter. Die erste Zeile ist ADDITIV — lesen Sie sie UND Ihre Absichtszeile, nicht das eine oder das andere.
| Bauen… | Lesen Sie zuerst (in Reihenfolge) |
|---|---|
| IMMER — jedes nicht-triviale Stück, zusätzlich zu Ihrer Absichtszeile unten | hyperframes-design/references/house-style.md + references/video-composition.md (auch in Schritt 1 / HARD-GATE erfasst; die „produziert, nicht generiert“ Vordergrund-Detaillierung) |
| Kinetische Typografie / textlastig | hyperframes-motion/techniques.md (kinetischer Typ) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Titelcard / Lower-Third / Overlay / PiP / Text-hinter-Subjekt | hyperframes-design/references/composition-patterns.md + (für den zentrierten/dimensionierten Frame) /hyperframes/core → „Root must be sized" |
| Logo / Markenzeichen-Enthüllung | hyperframes-motion/rules/svg-path-draw.md (zeichnen) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| Daten / Statistiken / Zahlen | hyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md |
| Produkt / App / UI-Demo | hyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Mehrere Szenen / Übergänge | hyperframes-motion/transitions/overview.md dann transitions/catalog.md (Sie sind nicht fertig nach dem Überblick — das GSAP-Rezept steht im Katalog) |
| Modulare / Sub-Kompositionen | /hyperframes/core/references/composition-patterns.md + references/sub-compositions.md |
Ausgabe-Checkliste → /hyperframes/cli
-
npx hyperframes lintundnpx hyperframes validatebestehen (auf Ergebnisse blockieren) - Designeinhaltung überprüft, falls eine Spezifikation (
frame.md/design.md) existiert — Checkliste inhyperframes-design/references/design-adherence.md -
npx hyperframes inspectbesteht, oder jeder Überlauf ist absichtlich markiert - Kontrastwarnungen adressiert; bei mehrszeniger Arbeit die Animationskarte prüfen (
hyperframes-motion/scripts/animation-map.mjs) - Vorschau bereitstellen; nur auf explizite Anfrage als MP4 rendern
- Die Vorschau nur bei Übergabe zeigen (es ist die stabile, endgültige Vorschau); keine während des Bauprozesses einblenden — Bauphasen-Schnappschüsse sind kopflos