media-use : Avant de sourcer des fichiers audio/images, appelez
/media-usepour résoudre les BGM/SFX/images du 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 le chemin avant l'Étape 0. Cette compétence crée une vidéo d' / à partir d'un site général. Si l'utilisateur fait vraiment du marketing / du lancement / de la promotion d'un produit (même depuis cette URL, même "promo pour notre site") →
/product-launch-video. Un sujet explicatif sans site →/faceless-explainer; une PR GitHub →/pr-to-video; recouper / recolorer / réordonner un fichier vidéo existant → hors du cadre. Aiguillé ici pour une demande vague "faire une vidéo", ou incertain entre lancement et site général ? Lisez d'abord/hyperframes(table de routage complète + § Ce que HyperFrames ne peut pas faire).
Les utilisateurs disent des choses comme :
- "Transforme ce site web en clip social de 15 secondes pour Instagram"
- "Fais une visite guidée / présentation de site de 30 secondes depuis https://..."
- "Capture notre page d'accueil et construis une vidéo à partir de ses propres visuels"
Le flux de travail comporte 7 étapes. Chacune produit un artefact qui conditionne la suivante. Par défaut, il est collaboratif — les jalons marqués 💬 s'arrêtent et demandent à l'utilisateur. Si l'utilisateur signale un mode autonome ("décide pour moi", "surprends-moi"), les jalons 💬 de préférence utilisateur sont ignorés ; voir step-2-brief.md pour savoir comment cela se propage.
Le mode autonome n'est PAS "ignorer tous les jalons". Le mode automatique couvre les questions de préférence utilisateur (fournisseur TTS, voix, accentuation des couleurs, nombre de temps, musique oui/non, sous-titres oui/non — où l'agent décide pour l'utilisateur). Il ne couvre PAS les jalons de vérification qualité. Les points suivants restent non sautables en mode auto :
- Audit des assets (Étape 3) — visualiser les planches contact et justifier UTILISER/IGNORER pour chaque asset
- Lecture HTML par temps (Étape 5) — bloc de preuve structuré par temps
- Checklist DoD (Étape 6) — y compris la map 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 de favoriser l'action, donc je vais sauter X" — et X est un jalon de vérification, pas une question de préférence — ce raisonnement est erroné. Favoriser l'action s'applique à décider quoi construire, pas à décider s'il faut 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, dans quelle voix il parle, dans quelle ambiance il vit. Les assets capturés sont une boîte à outils de marque pour plus tard, pas les blocs de construction de la vidéo.
Affichez le statut de connexion avant le brief — exécutez npx hyperframes auth status et retransmettez sa sortie textuellement (ne paraphrasez pas et ne réécrivez pas). Il indique si la voix/BGM utilisera les moteurs HeyGen ou locaux et, lorsque non connecté, comment se connecter. Si non connecté, ARRÊTEZ 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 passagère ; 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.
Jalon : Résumé du site imprimé — d'abord la stratégie (ce que fait le produit, à qui il s'adresse, voix de marque) avant l'inventaire des assets / couleurs / polices ; le statut de connexion a été affiché (connecté, ou continuant hors ligne).
Étape 1 : Identité de Marque
Lisez : references/step-1-design.md
Écrivez DESIGN.md — une antisèche 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 de rapidité : Pour les vidéos au rythme rapide (panneau par temps), DESIGN.md peut être un résumé de 50 lignes sur les couleurs + polices + à faire/à ne pas faire — pas un document de 300 lignes. Le prompt de sous-agent à l'Étape 5 colle directement les valeurs de marque, donc la profondeur de DESIGN.md n'importe que pour les compositions complexes.
Jalon : 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 — sections approfondies seulement si nécessaire)
Alignez-vous avec l'utilisateur sur ce que la vidéo doit communiquer avant de parler de visuels ou d'assets. Analysez le prompt de l'utilisateur — il vous a probablement déjà donné le type et le style de vidéo. Demandez seulement ce qui manque : la SEULE chose que cette vidéo doit dire, l'arc narratif, et le public.
Jalon : Le type de vidéo, la durée, le format, et — de manière critique — le message et l'arc narratif sont verrouillés. Sans cela, l'Étape 3 ne peut pas écrire un storyboard axé sur le concept.
Étape 3 : Storyboard et Script 💬
Lisez : references/step-3-storyboard.md
Écrivez le storyboard en priorisant le concept : message → arc narratif → temps qui servent l'arc → techniques par temps → passage des accents de marque à la fin. Ensuite, écrivez le script de narration correspondant. Présentez les deux à l'utilisateur avec un résumé temps par temps. Itérez jusqu'à approbation.
Jalon : 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 indique pas de narration — demandez pour 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 temps. Demandez ensuite pour les sous-titres.
Jalon : Soit (a) aucune narration n'a été demandée et le storyboard a des timings manuels par temps, soit (b) narration.wav + transcript.json existent et les timings des temps sont mis à jour avec les durées réelles.
Étape 5 : Construction des 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 temps avant de faire leur rapport.
Jalon : 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 temps se trouve dans step-5-build.md.
Étape 6 : Validation et Livraison
Lisez : references/step-6-validate.md
Lintez, validez, prenez des instantanés à l'échelle de la durée de la vidéo (formule : max(temps × 3, ceil(durée_secondes / 2))), et examinez chacun d'eux. 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 headless, donc ne faites pas apparaître 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.
Jalon : npx hyperframes lint et npx hyperframes validate réussissent avec zéro erreur, et la réponse finale inclut l'URL active du projet Studio.
Référence Rapide
Types de Vidéos
Contraintes typiques par type de vidéo — à utiliser comme point de départ, pas comme formule. Le nombre de temps doit découler du contenu et de la narration, pas d'une fourchette cible.
| Type | Durée typique | Facteur 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 |
| Vidéo de marque | 20–45s | Piste musicale | Optionnelle, focus musique |
| Teaser de lancement | 10–20s | Énergie de l'accroche | Minimale |
Le nombre de temps n'est pas intentionnellement dans ce tableau — il doit venir du storyboard, pas de "publicité sociale = 3-4 temps." Une publicité sociale pour un produit complexe pourrait nécessiter 5 temps bien rythmés. Une vidéo de marque avec une seule 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 le lire |
|---|---|
| step-0-capture.md | Étape 0 — capturer, comprendre la marque et le produit, écrire un résumé du site d'abord stratégique |
| step-1-design.md | Étape 1 — écrire DESIGN.md (5 sections, 250-350 lignes ; 50 lignes en mode rapide pour les publicités sociales de type panneau) |
| step-2-brief.md | Étape 2 — s'aligner sur le message, l'arc narratif, le public avec l'utilisateur |
| capabilities.md | Étapes 2 & 5 — inventaire complet de ce que 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 jalon 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 — linter, valider, instantanés (à l'échelle de la durée vidéo), aperçu |
| techniques.md | Étapes 3 & 5 — 13 techniques d'animation primitives avec patrons de code (adaptez, ne copiez-collez pas) |
| html-in-canvas-patterns.md | Étape 5 — patrons de code complets pour les effets HTML dans Canvas (vit dans la compétence hyperframes) |