general-video — création de composition générale
Confirmez la route avant de construire. Il s'agit du repli (fallback) pour la création de composition personnalisée. Si l'entrée correspond clairement à un workflow spécialisé, préférez-le : produit commercialisé →
/product-launch-video; site général →/website-to-video; explicateur de sujet →/faceless-explainer; PR GitHub →/pr-to-video; séquence existante →/embedded-captions·/graphic-overlays; motion design court non narré →/motion-graphics; port Remotion →/remotion-to-hyperframes. Hors périmètre : données en direct / au rendu, montage de type NLE d'une vidéo terminée, ou production de séquences qu'HyperFrames ne peut pas capturer. Incertain ? Lisez/hyperframesd'abord.
Construisez exactement ce qui a été demandé. Une carte-titre est une carte-titre — pas une carte-titre + trois scènes d'appoint + musique d'ambiance + sous-titres. Si des scènes ou éléments supplémentaires améliorent véritablement la pièce, proposez-les ; ne les ajoutez pas en silence. Pour les petites modifications (corriger une couleur, ajuster une durée, ajouter un élément), sautez les étapes de planification et passez directement à la construction.
Approche
Découverte — uniquement pour les demandes ouvertes
Pour les demandes vagues et exploratoires ("créez quelque chose pour notre marque", "une intro cool") — comprenez l'intention avant de choisir les couleurs :
- Audience — qui regarde ? développeurs / cadres / consommateurs généraux ?
- Plateforme — où est-ce diffusé ? réseaux sociaux (15s) / hero d'un site web / démo produit / interne ?
- Priorité — quel est le plus important ? qualité du mouvement / exactitude du contenu / fidélité à la marque / rapidité ?
- Variations — une seule meilleure version, ou 2-3 options significativement différentes (rythme, énergie ou structure différents — pas seulement des changements de couleur) ?
Pour les demandes spécifiques ("ajoutez une carte-titre", "corrigez le timing de la scène 3"), sautez la découverte.
Étape 1 — Système de design → hyperframes-creative
Établissez d'abord l'identité visuelle. Si le projet a un cahier des charges design, lisez-le (priorité frame.md → design.md → DESIGN.md ; traitez-le comme la vérité de la marque — couleurs, polices, contraintes exactes).
S'il n'existe pas de cahier des charges, vous DEVEZ lire À LA FOIS hyperframes-creative/references/house-style.md ET hyperframes-creative/references/video-composition.md avant de choisir une couleur ou une police. house-style.md donne l'ouverture "interpréter l'invite / générer du contenu réel", la liste des valeurs par défaut paresseuses et la recette des couches ; video-composition.md donne les règles de densité / échelle / détail du premier plan (barres de données, repères d'enregistrement, métadonnées monospace, "8-10 éléments, dont deux que l'utilisateur n'a pas demandés") qui séparent "produit" de "généré". Ne lire qu'un seul des deux est l'erreur la plus courante — video-composition.md est celui que les agents sautent, et c'est exactement celui qui empêche les rendus plats, centrés et ressemblant à des pages web. Ne vous inventez pas une palette et ne sautez pas ces fichiers ; passer par hyperframes-creative est obligatoire ici, pas une branche optionnelle. À partir de là, tirez également un style/ambiance nommé → references/visual-styles.md, ou le sélecteur interactif → references/design-picker.md, si nécessaire. Le cahier des charges / style définit la marque, pas les règles de composition.
Trouvez l'angle (brief vague, pas de cahier des charges) : avant de choisir les couleurs, écrivez UNE phrase — qu'est-ce que ce nom/mot/sujet évoque, et quel monde visuel (métaphore, décor, instrument, motif) l'exprime ? Par exemple, un outil de cybersécurité → portes de coffre / lignes de balayage de périmètre / gâches de serrure ; une application de méditation → marée, souffle, lente éclosion de lumière. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'un relooking littéral. C'est le substitut économique de l'expansion d'invite (Étape 2) pour les pièces à scène unique, où l'expansion est correctement ignorée — et c'est la différence entre un concept designé et un logo générique sur un dégradé.
Étape 2 — Expansion d'invite → hyperframes-creative
Exécutez pour toute composition multi-scènes (ignorez pour les pièces à scène unique et les modifications triviales). Ancrez la demande par rapport au cahier des charges de design + au style de la maison pour produire un intermédiaire cohérent que le travail en aval lira de la même manière. Voir hyperframes-creative/references/prompt-expansion.md.
Étape 3 — Planification
Avant d'écrire du HTML, pensez à un niveau élevé :
- Quoi — l'expérience du spectateur : arc narratif, moments clés, battements émotionnels.
- Structure — nombre de compositions, sous-comp vs inline, quelles pistes portent la vidéo / l'audio / les superpositions / les sous-titres. Pour la question fichier monolithique unique vs modulaire, voir
hyperframes-core/references/composition-patterns.md§ Deux architectures (règle empirique : ≥3 coupures de scène franches, ou toute scène réutilisée → modulariser ; une courte pièce à scène unique reste un seul fichier). - Rythme — nommez le motif avant de l'implémenter (par ex.
rapide-rapide-LENT-SHADER-tenu) ; voirhyperframes-creative/references/beat-direction.md. - Timing — quels clips déterminent la durée, où tombent les transitions, le pacing.
- Disposition — construisez d'abord l'état final (voir ci-dessous).
- Animer — puis ajoutez le mouvement via
hyperframes-animation.
Disposition avant animation
Positionnez chaque élément là où il se trouve à son moment le plus visible — complètement entré, correctement placé, pas encore en sortie. Écrivez cela d'abord en HTML + CSS statique. Pas encore de GSAP.
Pourquoi : si vous positionnez les éléments à leur état de départ animé (hors écran, mis à l'échelle à 0, opacité 0) et que vous créez une transition vers l'endroit où vous pensez qu'ils atterrissent, vous devinez la disposition finale — les chevauchements restent invisibles jusqu'au rendu. Construisez d'abord l'état final et vous voyez et corrigez les problèmes de disposition avant d'ajouter le mouvement.
- Identifiez l'image clé de chaque scène — le moment où le plus grand nombre d'éléments sont simultanément visibles. C'est la disposition que vous construisez.
- Écrivez le CSS statique pour cette image. Le conteneur de contenu doit remplir la scène avec du padding, pas des décalages absolus :
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* le padding positionne le contenu ; remplit n'importe quelle taille de scène */
gap: 24px;
box-sizing: border-box;
}
N'utilisez jamais position: absolute; top: Npx sur un conteneur de contenu — il déborde lorsque le contenu est plus grand que l'espace. Réservez le positionnement absolu pour les éléments décoratifs.
⚠ Le
width/height: 100%ci-dessus ne fonctionne que si chaque ancêtre a une hauteur définie. La racine<div data-composition-id>et tout wrapper entre elle et.scene-contentdoivent être dimensionnés (position: relative; width: 1920px; height: 1080pxsur la racine — voirhyperframes-core→ "La racine doit être dimensionnée"). Si vous ne le faites pas, le conteneur flex se réduit à ~0, le contenu s'empile dans le coin supérieur gauche, et le premier glyphe est tronqué à x=0 — tandis quelint/inspectsignalent encore 0 problème. Et gardez toujours lepadding(≥80px) sur.scene-content: c'est la marge de sécurité pour le titre. Ne le remplacez jamais par un simplegap.
- Ajoutez les entrées — animez DEPUIS hors écran/invisible VERS la position CSS avec
gsap.from()(dans les sous-compositions, préférezgsap.fromTo()pour que l'état de départ soit explicite ; voirhyperframes-core/references/sub-compositions.md). La position CSS est la vérité de base ; la transition est le chemin pour y parvenir. - Les sorties sont gérées par les transitions — selon les règles de transition de scène dans
hyperframes-animation/transitions/, seule la dernière scène anime les éléments en sortie ; entre les scènes, la transition EST la sortie.
Espace partagé dans le temps : si l'élément A sort avant que l'élément B n'entre dans la même zone, les deux ont toujours besoin de positions CSS correctes pour leurs images clés respectives — l'ordre chronologique les empêche de coexister, et l'étape de disposition détecte les chevauchements accidentels. Les lueurs/ombres superposées et la profondeur en z-stack sont des chevauchements intentionnels ; l'étape consiste à détecter les collisions non intentionnelles (deux titres l'un sur l'autre, contenu sortant du cadre).
Construction — déléguez aux compétences de domaine
Ceci mappe la surface complète de la compétence (voir la description) à ses références — non exhaustif ; lorsqu'une intention n'est pas listée, acheminez via hyperframes-creative (aspect/ concept), hyperframes-animation (mouvement), hyperframes-core (contrat), hyperframes-media (audio/sous-titres). La première ligne est ADDITIVE — lisez-la ET votre ligne d'intention, pas l'une ou l'autre.
| Vous construisez… | Lisez d'abord (dans l'ordre) |
|---|---|
| TOUJOURS — toute pièce non triviale, en plus de votre ligne d'intention ci-dessous | hyperframes-creative/references/house-style.md + references/video-composition.md (également exigé à l'Étape 1 / HARD-GATE ; le détail du premier plan "produit, pas généré") |
| Typographie cinétique / orientée texte | hyperframes-animation/techniques.md (type cinétique) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Carte-titre / tiers inférieur / superposition / PiP / texte derrière le sujet | hyperframes-creative/references/composition-patterns.md + (pour le cadre centré/dimensionné) hyperframes-core → "La racine doit être dimensionnée" |
| Révélation de logo / marque | hyperframes-animation/rules/svg-path-draw.md (dessin) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| Données / statistiques / chiffres | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| Démo produit / application / UI | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Audio-réactif / piloté par la musique | hyperframes-creative/references/audio-reactive.md (pré-extraire les bandes ; mapper au mouvement) |
| Narré / voix off / sous-titres / légendes | hyperframes-media (tts, transcribe, création de sous-titres) → placer les assets via hyperframes-core |
| Multi-scènes / transitions | hyperframes-animation/transitions/overview.md puis transitions/catalog.md (vous n'avez pas fini après l'aperçu — la recette GSAP est dans le catalogue) |
| Modulaire / sous-compositions | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
Liste de vérification de sortie → hyperframes-cli
-
npx hyperframes lintetnpx hyperframes validateréussissent (bloquer sur les résultats) - conformité au design vérifiée si un cahier des charges (
frame.md/design.md) existe — liste de vérification danshyperframes-creative/references/design-adherence.md -
npx hyperframes inspectréussit, ou tout débordement est intentionnellement marqué - avertissements de contraste traités ; pour le travail multi-scènes, révisez la carte d'animation (
hyperframes-animation/scripts/animation-map.mjs) - livrez l'aperçu ; ne rendez en MP4 que sur demande explicite
- présentez l'aperçu uniquement à la livraison (c'est l'aperçu final stable) ; n'en affichez pas un en cours de construction — les instantanés de phase de construction sont sans tête (headless)
Pas ce workflow
- Un produit / entreprise / SaaS / site web spécifique en cours de commercialisation, lancement ou promotion →
/product-launch-video - Un concept / sujet / article / comment-X-fonctionne expliqué, sans produit →
/faceless-explainer - Une PR GitHub / modification de code →
/pr-to-video - Une vidéo existante avec une personne qui parle à laquelle ajouter des sous-titres →
/embedded-captions - Le port d'une composition Remotion existante →
/remotion-to-hyperframes - Le montage / l'édition d'un fichier vidéo fini comme un NLE → hors périmètre (HyperFrames compose du HTML et des médias dans une timeline déterministe ; il ne monte pas de séquences)