general-video — workflow vidéo général
Confirmez la voie avant de construire. Ceci est le repli pour la création de compositions personnalisées. Si l'entrée correspond clairement à un workflow spécialisé, privilégiez-le : explication de sujet →
/faceless-explainer; PR GitHub →/pr-to-video; images existantes →/embedded-captions·/talking-head-recut; court motion design non narré →/motion-graphics. Hors périmètre : données en direct / au moment du rendu, montage de type NLE d'une vidéo terminée, ou production d'images que HyperFrames ne peut pas capturer. En cas de doute ? Lisez/hyperframesd'abord.
Construisez exactement ce qui a été demandé. Un carton-titre est un carton-titre — pas un carton-titre + trois scènes secondaires + légendes. Si des scènes ou éléments supplémentaires amélioreraient vraiment 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 — requêtes ouvertes uniquement
Pour les demandes vagues et exploratoires (« crée quelque chose pour notre marque », « une intro cool ») — comprenez l'intention avant de choisir les couleurs :
- Public — qui regarde ? développeurs / cadres / consommateurs grand public ?
- Plateforme — où est-ce diffusé ? réseaux sociaux (15s) / site web hero / démo produit / interne ?
- Priorité — qu'est-ce qui compte le plus ? 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 (« ajoute un carton-titre », « corrige le timing de la scène 3 »), sautez la découverte.
Étape 1 — Système de design → hyperframes-design
Établissez d'abord l'identité visuelle. Si le projet a un cahier des charges de 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-design/references/house-style.md ET hyperframes-design/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étails de premier plan (barres de données, marques d'enregistrement, métadonnées monospace, « 8 à 10 éléments, dont deux que l'utilisateur n'a pas demandés ») qui séparent le « produit » du « généré ». Lire 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 une sortie plate, centrée et ressemblant à une page web. N'inventez pas vous-même une palette et ne sautez pas ces lectures ; passer par hyperframes-design est obligatoire ici, pas une branche facultative. À partir de là, tirez également un style/ambiance nommé → references/visual-styles.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-t-il ? Par exemple, un outil de cybersécurité → portes de coffre / lignes de balayage périmétrique / garnitures de serrure ; une application de méditation → marée, souffle, douce éclosion de lumière. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'une retouche littérale. C'est le substitut économique à l'expansion de l'invite (Étape 2) pour les pièces à une seule scène, où l'expansion est correctement ignorée — et c'est la différence entre un concept conçu et un logo générique sur un dégradé.
Étape 2 — Expansion de l'invite → hyperframes-design
Exécutez-la pour chaque composition multi-scènes (ignorez-la pour les pièces à une seule scène et les modifications triviales). Ancrez la demande par rapport au cahier des charges de design + style maison dans un intermédiaire cohérent que les travaux en aval lisent de la même manière. Voir hyperframes-design/references/prompt-expansion.md.
Étape 3 — Planifier
Avant d'écrire le HTML, réfléchissez à un niveau élevé :
- Quoi — l'expérience du spectateur : arc narratif, moments clés, battements émotionnels.
- Structure — combien de compositions, sous-comp vs en ligne, quelles pistes portent la vidéo / les incrustations / les légendes. Pour l'appel entre fichier monolithique unique vs modulaire, voir
/hyperframes/core/references/composition-patterns.md§ Two Architectures (règle empirique : ≥3 cuts de scène durs, ou toute scène réutilisée → modulariser ; une pièce courte à scène unique reste un seul fichier). - Rythme — nommez le motif avant de l'implémenter (par ex.
fast-fast-SLOW-SHADER-hold) ; voirhyperframes-design/references/beat-direction.md. - Timing — quels clips déterminent la durée, où se situent les transitions, le rythme.
- Mise en page — construisez d'abord l'état final (voir ci-dessous).
- Animer — ajoutez ensuite le mouvement via
hyperframes-motion.
Mise en page avant l'animation
Positionnez chaque élément là où il se trouve à son moment le plus visible — complètement entré, correctement placé, pas encore en train de sortir. Écrivez cela d'abord en HTML + CSS statique. Pas encore de GSAP.
Pourquoi : si vous positionnez les éléments à leur état initial animé (hors écran, mis à l'échelle 0, opacité 0) et que vous animez vers l'endroit où vous pensez qu'ils atterrissent, vous devinez la mise en page finale — les chevauchements restent invisibles jusqu'au rendu. Construisez d'abord l'état final et vous voyez et corrigez les problèmes de mise en page avant d'ajouter le mouvement.
- Identifiez l'image héroïque pour chaque scène — le moment où le plus d'éléments sont simultanément visibles. C'est la mise en page 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 haut que l'espace. Réservez le positionnement absolu aux éléments décoratifs.
⚠ Les
width/height: 100%ci-dessus ne fonctionnent que si chaque ancêtre a une hauteur résolue. 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 — voir/hyperframes/core→ « Root must be sized »). Ignorez cela et le conteneur flex s'effondre à ~0, le contenu s'empile dans le coin supérieur gauche, et le premier glyphe est coupé à x=0 — tandis quelint/inspectsignalent encore 0 problème. Et conservez toujours lepadding(≥80px) sur.scene-content: c'est la marge de sécurité du carton-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ébut soit explicite ; voir/hyperframes/core/references/sub-compositions.md). La position CSS est la vérité de référence ; l'interpolation est le voyage vers elle. - Les sorties sont gérées par les transitions — conformément aux règles de transition de scène dans
hyperframes-motion/transitions/, seule la dernière scène anime les éléments vers l'extérieur ; 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 héroïques respectives — l'ordre chronologique les empêche de coexister, et l'étape de mise en page détecte le chevauchement accidentel. Les lueurs/superpositions en couches et la profondeur en z-stack sont un chevauchement intentionnel ; l'étape vise à 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 cartographie la surface complète du skill (voir la description) vers ses références — non exhaustive ; lorsqu'une intention n'est pas listée, acheminez via hyperframes-design (aspect/concept), hyperframes-motion (mouvement), /hyperframes/core (contrat). La première ligne est ADDITIVE — lisez-la ET votre ligne d'intention, pas l'une ou l'autre.
| Construction… | Lisez d'abord (dans l'ordre) |
|---|---|
| TOUJOURS — chaque pièce non triviale, en plus de votre ligne d'intention ci-dessous | hyperframes-design/references/house-style.md + references/video-composition.md (également conditionné à l'Étape 1 / HARD-GATE ; les détails de premier plan « produit, pas généré ») |
| Typographie cinétique / textuel | hyperframes-motion/techniques.md (type cinétique) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Carton-titre / tiers inférieur / incrustation / PiP / texte derrière le sujet | hyperframes-design/references/composition-patterns.md + (pour le cadre centré/dimensionné) /hyperframes/core → « Root must be sized » |
| Révélation de logo / identité de marque | hyperframes-motion/rules/svg-path-draw.md (dessin) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| Données / statistiques / chiffres | hyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md |
| Démo produit / application / UI | hyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Multi-scènes / transitions | hyperframes-motion/transitions/overview.md puis transitions/catalog.md (vous n'avez pas fini après la vue d'ensemble — la recette GSAP est dans le catalogue) |
| Modulaire / sous-compositions | /hyperframes/core/references/composition-patterns.md + references/sub-compositions.md |
Liste de contrôle 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 contrôle danshyperframes-design/references/design-adherence.md -
npx hyperframes inspectréussit, ou chaque débordement est intentionnellement marqué - avertissements de contraste traités ; pour un travail multi-scènes, examinez la carte d'animation (
hyperframes-motion/scripts/animation-map.mjs) - livrez l'aperçu ; rendez au format MP4 uniquement sur demande explicite
- montrez l'aperçu uniquement à la remise (c'est l'aperçu final stable) ; n'en affichez pas un en cours de construction — les instantanés de la phase de construction sont sans tête