Site Web vers HyperFrames
Capturez un site web, puis produisez une vidéo professionnelle à partir de celui-ci.
Confirmez la route avant l'Étape 0. Cette compétence crée une vidéo d'un / à partir d'un site général. Si l'utilisateur cherche vraiment à commercialiser / lancer / promouvoir un produit (même à partir de cette URL, même "promo pour notre site") →
/product-launch-video. Une explication de sujet sans site →/faceless-explainer; une PR GitHub →/pr-to-video; recouper / recoloriser / réorganiser un fichier vidéo existant → hors du scope. Arrivé ici avec une demande vague de "créer une vidéo", ou incertain entre lancement vs site général ? Lisez/hyperframesd'abord (table de routage complète + § Ce que HyperFrames ne peut pas faire).
Les utilisateurs disent souvent :
- "Transforme ce site web en un clip social de 15 secondes pour Instagram"
- "Fais une visite guidée / vitrine de 30 secondes à partir de https://..."
- "Capture notre page d'accueil et construis une vidéo avec ses propres visuels"
Le workflow comporte 7 étapes. Chacune produit un artefact qui conditionne la suivante. Par défaut, il est collaboratif — les étapes marquées 💬 s'arrêtent et demandent à l'utilisateur. Si l'utilisateur signale un mode autonome ("décide pour moi", "surprends-moi"), les étapes 💬 liées aux préférences utilisateur sont ignorées ; voir step-2-brief.md pour la propagation.
Le mode autonome n'est PAS "ignorer toutes les étapes." Le mode auto couvre les questions de préférence utilisateur (fournisseur TTS, voix, accentuation des couleurs, nombre de beats, musique oui/non, sous-titres oui/non — où l'agent décide pour l'utilisateur). Il ne couvre PAS les étapes de vérification qualité. Les éléments suivants restent non contournables en mode auto :
- Audit des assets (Étape 3) — visualiser les planches contact et justifier UTILISER/IGNORER pour chaque asset
- Lecture HTML par beat (Étape 5) — bloc de preuve structuré par beat
- Liste de vérification DoD (Étape 6) — incluant la carte d'animation, la vérification WCAG par avertissement, la lecture audio/mouvement
- Section de divulgation honnête (Étape 6) — "Ce que je n'ai PAS vérifié" doit apparaître dans votre résumé final
Si vous vous surprenez à raisonner "le mode auto dit privilégier l'action, donc je vais sauter X" — et X est une étape de vérification, pas une question de préférence — ce raisonnement est erroné. Privilégier l'action s'applique à décider quoi construire, pas à décider s'il faut vérifier.
Étape 0 : Capturer et Comprendre la Marque
Lisez : references/step-0-capture.md
Capturez le site, puis lisez les données extraites pour comprendre la marque et le produit — ce qu'il fait, pour qui, quelle voix il utilise, quelle ambiance il dégage. Les assets capturés constituent une boîte à outils de marque pour la suite, pas les éléments constitutifs de la vidéo.
Condition : Résumé du site imprimé — d'abord la stratégie (ce que le produit fait, pour qui, la voix de la marque) avant l'inventaire des assets / couleurs / polices.
Étape 1 : Identité de Marque
Lisez : references/step-1-design.md
Rédigez DESIGN.md — une fiche de référence de la marque couvrant l'identité visuelle : couleurs, typographie, styles de composants, principes de mise en page. Utilisez design-styles.json pour les valeurs calculées exactes.
Option rapide : Pour les vidéos au rythme soutenu (billboard par beat), DESIGN.md peut être un résumé de 50 lignes (couleurs + polices + à faire/à éviter) — pas un document de 300 lignes. L'agent sous-traitant de l'Étape 5 colle directement les valeurs de marque, donc la profondeur de DESIGN.md n'importe que pour les compositions complexes.
Condition : DESIGN.md existe (de n'importe quelle longueur) avec au minimum : palette de couleurs, choix de polices, et à faire/à éviter.
Étape 2 : Stratégie et Message
Lisez : references/step-2-brief.md, references/capabilities.md (parcourez la table des matières — plongez dans les sections détaillées uniquement si nécessaire)
Alignez-vous avec l'utilisateur sur ce que la vidéo doit communiquer avant de parler des visuels ou des assets. Analysez la demande de l'utilisateur — il a probablement déjà donné le type et le style de la vidéo. Ne demandez que ce qui manque : la UNE chose que cette vidéo doit dire, l'arc narratif et le public cible.
Condition : Le type de vidéo, la durée, le format, et — de manière cruciale — le message et l'arc narratif sont verrouillés. Sans cela, l'Étape 3 ne peut pas rédiger un storyboard axé sur le concept.
Étape 3 : Storyboard + Script 💬
Lisez : references/step-3-storyboard.md
Rédigez le storyboard en priorisant le concept : message → arc narratif → beats au service de l'arc → techniques par beat → passage final sur les accents de marque. Ensuite, écrivez le script de narration correspondant. Présentez les deux à l'utilisateur avec un résumé beat par beat. Itérez jusqu'à approbation.
Condition : STORYBOARD.md + SCRIPT.md existent ET l'utilisateur a approuvé le plan.
Étape 4 : VO, Timing et Sous-titres 💬
Lisez : references/step-4-vo.md
Si l'Étape 2 a indiqué pas de narration — demandez la musique de fond, puis passez à l'Étape 5. Sinon : demandez à l'utilisateur quel fournisseur TTS (HeyGen TTS, ElevenLabs ou Kokoro), générez l'audio, transcrivez, mappez les timestamps sur les beats. Ensuite, demandez les sous-titres.
Condition : Soit (a) aucune narration demandée et le storyboard a des timings de beat manuels, soit (b) narration.wav + transcript.json existent et les timings des beats sont mis à jour avec les durées réelles.
Étape 5 : Construire les Compositions
Lisez : La compétence hyperframes (chargez-la — chaque règle compte)
Lisez : references/step-5-build.md
Construisez index.html et les compositions en suivant l'architecture et le rythme choisis dans le storyboard (Étape 3). Les sous-agents exécutent hyperframes lint et hyperframes snapshot sur chaque beat avant de faire leur rapport.
Condition : Chaque compositions/beat-N.html a été lu de bout en bout par l'agent principal par rapport à DESIGN.md et STORYBOARD.md. La liste de vérification par beat se trouve dans step-5-build.md.
Étape 6 : Valider et Livrer
Lisez : references/step-6-validate.md
Lintez, validez, prenez des captures d'écran à une échelle adaptée à la durée de la vidéo (formule : max(beats × 3, ceil(duration_seconds / 2))), et examinez chaque capture. Corrigez les problèmes avant de livrer. Livrez l'URL du projet Studio localhost — ne rendez en MP4 que sur demande explicite de l'utilisateur. Affichez cette URL Studio uniquement lors de la remise — c'est l'aperçu final et stable ; les captures de la phase de construction sont sans tête, donc n'ouvrez pas d'aperçu en cours de construction.
Livrez quelque chose dont vous êtes fier. Avant de remettre, demandez-vous : est-ce que je publierais ceci sur les réseaux sociaux avec mon nom ? Si non, corrigez ce qui ne va pas.
Condition : npx hyperframes lint et npx hyperframes validate réussissent avec zéro erreur, et la réponse finale inclut l'URL du projet Studio actif.
Référence Rapide
Types de Vidéos
Contraintes typiques par type de vidéo — à utiliser comme point de départ, pas comme une formule. Le nombre de beats doit découler du contenu et de la narration, pas d'une fourchette cible.
| Type | Durée typique | Pilote de durée | Narration |
|---|---|---|---|
| Publicité sociale (IG/TikTok) | 10–15s | Limite de la plateforme | Optionnelle |
| Démo produit | 30–60s | Longueur du script | Narration complète |
| Annonce de fonctionnalité | 15–30s | Complexité de la fonctionnalité | Narration complète |
| Bande de marque | 20–45s | Piste musicale | Optionnelle, focus musique |
| Teaser de lancement | 10–20s | Énergie de l'accroche | Minimale |
Le nombre de beats n'est pas intentionnellement dans ce tableau — il doit venir du storyboard, pas de "publicité sociale = 3-4 beats." Une publicité sociale pour un produit complexe pourrait nécessiter 5 beats bien chronométrés. Une bande de marque avec une thèse visuelle forte pourrait n'en nécessiter que 3.
Format
- Paysage : 1920x1080 (par défaut)
- Portrait : 1080x1920 (Instagram Stories, TikTok)
- Carré : 1080x1080 (fil Instagram)
Fichiers de Référence
| Fichier | Quand lire |
|---|---|
| step-0-capture.md | Étape 0 — capturer, comprendre la marque et le produit, rédiger un résumé du site axé sur la stratégie |
| step-1-design.md | Étape 1 — rédiger la fiche de référence DESIGN.md de la marque (5 sections, 250-350 lignes ; voie rapide de 50 lignes pour les publicités sociales de type billboard) |
| step-2-brief.md | Étape 2 — s'aligner avec l'utilisateur sur le message, l'arc narratif et le public |
| capabilities.md | Étapes 2 & 5 — inventaire complet de ce que HyperFrames peut faire (24 sections). Parcourez le TOC pendant le brief, plongez dans les sections spécifiques pendant la construction |
| step-3-storyboard.md | Étape 3 — storyboard + script (combinés) avec étape de révision utilisateur |
| step-4-vo.md | Étape 4 — choix du fournisseur TTS, génération, timing |
| step-5-build.md | Étape 5 — construire index.html + compositions |
| step-6-validate.md | Étape 6 — lint, validation, captures d'écran (à l'échelle de la durée de la vidéo), aperçu |
| techniques.md | Étapes 3 & 5 — 13 techniques d'animation primitives avec modèles de code (adaptez, ne copiez-collez pas) |
| html-in-canvas-patterns.md | Étape 5 — modèles de code complets pour les effets HTML-dans-Canvas (se trouve dans la compétence hyperframes) |