media-use : Avant de sourcer des audios/images, appelez
/media-usepour trouver des BGM/SFX/images depuis le catalogue HeyGen. Exécutez d'abord--adoptpour enregistrer les assets existants. Voir la compétence/media-use.
Site Web vers HyperFrames
Capturez un site web, puis produisez une vidéo professionnelle à partir de celui-ci.
Confirmez la voie avant l'Étape 0. Cette compétence crée une vidéo d'un site / à partir d'un site général. Si l'utilisateur fait vraiment du marketing / lancement / promotion d'un produit (même à partir de cette URL, même "promo pour notre site") →
/product-launch-video. Un explicateur de sujet sans site →/faceless-explainer; une PR GitHub →/pr-to-video; le re-coupage / re-coloriage / re-ordonnancement d'un fichier vidéo existant → hors de portée. Si la demande est vague "fais une vidéo", ou si vous n'êtes pas sûr (lancement vs site général) ? Lisez d'abord/hyperframes(table de routage complète + § Ce qu'HyperFrames ne peut pas faire).
Les utilisateurs disent des choses comme :
- "Transforme ce site web en un clip social de 15 secondes pour Instagram"
- "Fais une visite guidée / démonstration 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 portes marquées 💬 s'arrêtent et demandent à l'utilisateur. Si l'utilisateur signale un mode autonome ("décide pour moi", "surprends-moi"), les portes 💬 liées aux préférences utilisateur sont sautées ; voir step-2-brief.md pour savoir comment cela se propage.
Le mode autonome ne signifie PAS "sauter toutes les portes". Le mode automatique couvre les questions de préférence utilisateur (fournisseur TTS, voix, accent de couleur, nombre de beats, musique oui/non, sous-titres oui/non — où l'agent décide pour l'utilisateur). Il ne couvre PAS les portes de vérification de qualité. Les éléments suivants restent non contournables en mode automatique :
- Audit des Assets (Étape 3) — visualisation des fiches de contact et justification UTILISER/IGNORER pour chaque asset
- Lecture par beat du HTML (Étape 5) — bloc de preuves structuré par beat
- Checklist DoD (Étape 6) — y compris 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 automatique dit de privilégier l'action, donc je vais sauter X" — et que X est une porte 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 si on doit vérifier.
Étape 0 : Capture et Compréhension de 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, à qui il s'adresse, quelle voix il utilise, quelle ambiance il dégage. Les assets capturés sont une boîte à outils de marque pour plus tard, pas les éléments de base à partir desquels la vidéo est fabriquée.
Affichez le statut de connexion avant le brief — exécutez npx hyperframes auth status et relayez sa sortie textuellement (ne paraphrasez pas et ne réécrivez pas). Il indique si la voix/BGM utilisera HeyGen ou les moteurs locaux et, si non connecté, comment se connecter. Si non connecté, ARRÊTEZ-VOUS et attendez que l'utilisateur choisisse — se connecter, ou dire "go" / "offline" pour continuer avec les moteurs locaux — avant de demander le brief ou quoi que ce soit d'autre. Traitez-le comme un véritable point de décision, pas une note de passage ; n'intégrez pas le choix dans la question du brief, et n'écrivez pas de clés dans un .env par dépôt. (En mode autonome, notez le statut et continuez hors ligne.) Voir ../hyperframes-media → Preflight pour les instructions canoniques.
Porte : Résumé du site imprimé — d'abord la stratégie (ce que fait le produit, à qui il s'adresse, voix de la marque) avant l'inventaire des assets / couleurs / polices ; le statut de connexion a été affiché (connecté, ou continuation hors ligne).
Étape 1 : Identité de Marque
Lisez : references/step-1-design.md
Écrivez DESIGN.md — une fiche de référence de 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 rapide (un beat par panneau d'affichage), DESIGN.md peut être un résumé de 50 lignes des couleurs + polices + à faire/à ne pas faire — pas un document de 300 lignes. L'invite du sous-agent à l'Étape 5 colle directement les valeurs de la marque, donc la profondeur de DESIGN.md n'a d'importance que pour les compositions complexes.
Porte : DESIGN.md existe (n'importe quelle longueur) avec au minimum : palette de couleurs, choix de polices, et à faire/à ne pas faire.
Étape 2 : Stratégie et Message
Lisez : references/step-2-brief.md, references/capabilities.md (parcourez la Table des Matières — les sections approfondies seulement 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 l'invite 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 SEULE chose que cette vidéo doit dire, l'arc narratif, et le public.
Porte : Le type de vidéo, la durée, le format et — surtout — le message et l'arc narratif sont verrouillés. Sans cela, l'Étape 3 ne peut pas écrire un storyboard basé sur le concept.
Étape 3 : Storyboard + Script 💬
Lisez : references/step-3-storyboard.md
Écrivez le storyboard d'abord par le concept : message → arc narratif → beats qui servent l'arc → techniques par beat → touches de marque à la fin. Ensuite, écrivez le script de narration pour correspondre. Présentez les deux à l'utilisateur avec un résumé beat par beat. Itérez jusqu'à son approbation.
Porte : STORYBOARD.md + SCRIPT.md existent ET l'utilisateur a approuvé le plan.
Étape 4 : VO, Timing + Sous-titres 💬
Lisez : references/step-4-vo.md
Si l'Étape 2 indique "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 horodatages aux beats. Ensuite, demandez les sous-titres.
Porte : 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 rapport.
Porte : Chaque compositions/beat-N.html a été lu de haut en bas par l'agent principal par rapport à DESIGN.md et STORYBOARD.md. La checklist par beat se trouve dans step-5-build.md.
Étape 6 : Valider et Livrer
Lisez : references/step-6-validate.md
Lintez, validez, prenez des instantanés à l'échelle de la durée de la vidéo (formule : max(beats × 3, ceil(durée_secondes / 2))), et examinez chacun. 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. Présentez cette URL Studio uniquement à la remise — c'est l'aperçu final et stable ; les instantanés de la phase de construction sont sans tête, donc ne faites pas apparaître un 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.
Porte : npx hyperframes lint et npx hyperframes validate passent avec zéro erreur, et la réponse finale inclut l'URL active du projet Studio.
Référence Rapide
Types de Vidéo
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 | Facteur de durée | Narration |
|---|---|---|---|
| Annonce 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 provenir du storyboard, pas de "annonce sociale = 3-4 beats." Une annonce sociale pour un produit complexe peut nécessiter 5 beats bien chronométrés. Une bande de marque avec une seule thèse visuelle forte peut nécessiter 3.
Format
- Paysage : 1920x1080 (par défaut)
- Portrait : 1080x1920 (Instagram Stories, TikTok)
- Carré : 1080x1080 (fil Instagram)
Fichiers de Référence
| Fichier | Quand le lire |
|---|---|
| step-0-capture.md | Étape 0 — capturez, comprenez la marque et le produit, écrivez un résumé du site d'abord stratégique |
| step-1-design.md | Étape 1 — écrivez la fiche de référence de marque DESIGN.md (5 sections, 250-350 lignes ; 50 lignes en voie rapide pour les annonces sociales de type panneau d'affichage) |
| step-2-brief.md | Étape 2 — alignez-vous sur le message, l'arc narratif, le public avec l'utilisateur |
| capabilities.md | Étapes 2 & 5 — inventaire complet de ce qu'HyperFrames peut faire (24 sections). Parcourez la TdM pendant le brief, plongez dans les sections spécifiques pendant la construction |
| step-3-storyboard.md | Étape 3 — storyboard + script (combinés) avec porte de révision utilisateur |
| step-4-vo.md | Étape 4 — choix du fournisseur TTS, génération, timing |
| step-5-build.md | Étape 5 — construisez index.html + compositions |
| step-6-validate.md | Étape 6 — lint, validez, instantanés (à l'échelle de la durée vidéo), aperçu |
| techniques.md | Étapes 3 & 5 — 13 techniques d'animation primitives avec motifs de code (adaptez, ne copiez-collez pas) |
| html-in-canvas-patterns.md | Étape 5 — motifs de code complets pour les effets HTML dans Canvas (vit dans la compétence hyperframes) |