utilisation-medias : Avant de sourcer audio/images, appelez
/media-usepour résoudre BGM/SFX/images depuis le catalogue HeyGen. Exécutez--adoptd'abord pour 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 réalise une vidéo d'un / à partir d'un site général. Si l'utilisateur commercialise / lance / promeut réellement 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; ré-couper / re-coloriser / réorganiser un fichier vidéo existant → hors du champ. Aiguillé ici sur un vague "crée une vidéo", ou incertain lancement-vs-site-général ? Lisez/hyperframesd'abord (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 / vitrine de 30 secondes à partir de https://..."
- "Capture notre page d'accueil et construis une vidéo à partir de ses propres visuels"
Le workflow comporte 7 étapes. Chacune produit un artefact qui conditionne la suivante. Par défaut, il est collaboratif — les points de contrôle marqués 💬 s'arrêtent et demandent à l'utilisateur. Si l'utilisateur signale le mode autonome ("décide pour moi", "surprends-moi"), les points de contrôle 💬 relatifs aux préférences utilisateur sont ignorés ; voir step-2-brief.md pour savoir comment cela se propage.
Le mode autonome N'est PAS "ignorer tous les points de contrôle." Le mode auto 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 points de contrôle de vérification de qualité. Les éléments suivants restent non optionnels en mode autonome :
- Audit des assets (Étape 3) — visualisation des planches contact et justification UTILISER/IGNORER pour chaque asset
- Lecture HTML par temps (Étape 5) — bloc de preuve structuré par temps
- Liste de critères de fin (É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 favoriser l'action, donc je vais ignorer X" — et que X est un point de contrôle de vérification, pas une question de préférence — ce raisonnement est erroné. Favoriser l'action s'applique à la décision de quoi construire, pas à la décision de vérifier ou non.
Étape 0 : Capture & Comprendre la Marque
Lire : 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 il est, quelle voix il parle, quelle ambiance il habite. Les assets capturés sont une boîte à outils de marque pour plus tard, pas les éléments constitutifs de la vidéo.
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 des moteurs locaux et, si non connecté, comment se connecter. Si non connecté, ARRÊTEZ et attendez que l'utilisateur choisisse — se connecter, ou dire "go"/"hors ligne" 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 les clés dans un .env par dépôt. (En mode autonome, notez le statut et continuez hors ligne.) Voir ../hyperframes-media → Pré-vol pour les instructions canoniques.
Point de contrôle : Résumé du site imprimé — stratégie d'abord (ce que fait le produit, pour qui, voix de marque) avant l'inventaire des assets / couleurs / polices ; statut de connexion affiché (connecté, ou continuant hors ligne).
Étape 1 : Identité de Marque
Lire : 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 exactes calculées.
Option rapide : Pour les vidéos au rythme soutenu (panneau par temps), 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 marque, donc la profondeur de DESIGN.md n'a d'importance que pour les compositions complexes.
Point de contrôle : DESIGN.md existe (de n'importe quelle longueur) avec au minimum : palette de couleurs, choix de polices, et à faire/à ne pas faire.
Étape 2 : Stratégie & Messagerie
Lire : references/step-2-brief.md, references/capabilities.md (parcourez la Table des Matières — sections approfondies uniquement si nécessaire)
Alignez-vous avec l'utilisateur sur ce que la vidéo doit communiquer avant de parler visuels ou assets. Analysez l'invite de l'utilisateur — il a probablement déjà donné le type et le style de vidéo. Ne demandez que ce qui manque : la SEULE chose que cette vidéo doit dire, l'arc narratif et le public.
Point de contrôle : Le type de vidéo, la durée, le format et — crucialement — le message et l'arc narratif sont verrouillés. Sans cela, l'Étape 3 ne peut pas écrire un storyboard conceptuel.
Étape 3 : Storyboard + Script 💬
Lire : references/step-3-storyboard.md
Écrivez le storyboard en commençant par le concept : message → arc narratif → temps qui servent l'arc → techniques par temps → ajustements de la marque à la fin. Écrivez ensuite le script de narration correspondant. Présentez les deux à l'utilisateur avec un résumé temps par temps. Itérez jusqu'à approbation.
Point de contrôle : STORYBOARD.md + SCRIPT.md existent ET l'utilisateur a approuvé le plan.
Étape 4 : VO, Timing + Sous-titres 💬
Lire : references/step-4-vo.md
Si l'Étape 2 a dit 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.
Point de contrôle : Soit (a) aucune narration n'a été demandée et le storyboard a des timings manuels pour les temps, soit (b) narration.wav + transcript.json existent et les timings des temps sont mis à jour avec les durées réelles.
Étape 5 : Construire les Compositions
Lire : La compétence hyperframes (chargez-la — chaque règle compte)
Lire : 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 rapport.
Point de contrôle : 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 contrôle par temps se trouve dans step-5-build.md.
Étape 6 : Valider & Livrer
Lire : references/step-6-validate.md
Lintez, validez, prenez des captures d'écran adaptées à la durée de la vidéo (formule : max(temps × 3, ceil(durée_secondes / 2))), et examinez chacune. 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 du transfert — c'est l'aperçu stable final ; les captures d'écran en phase de construction sont sans tête, donc n'affichez pas d'aperçu en cours de construction.
Livrez quelque chose dont vous êtes fier. Avant de remettre, demandez-vous : publierais-je ceci sur les réseaux sociaux avec mon nom ? Si non, corrigez ce qui ne va pas.
Point de contrôle : npx hyperframes lint et npx hyperframes validate passent avec zéro erreur, et la réponse finale inclut l'URL du projet Studio actif.
Référence Rapide
Types de Vidéo
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 plage 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 fonc. | Narration complète |
| Reel de marque | 20–45s | Piste musicale | Optionnelle, focus musique |
| Teaser de lancement | 10–20s | Énergie d'accroche | Minimale |
Le nombre de temps n'est pas intentionnellement dans ce tableau — il doit venir du storyboard, pas de "pub sociale = 3-4 temps." Une pub sociale pour un produit complexe pourrait nécessiter 5 temps bien rythmés. Un reel de marque avec une thèse visuelle forte pourrait nécessiter 3 temps.
Format
- Paysage : 1920x1080 (par défaut)
- Portrait : 1080x1920 (Stories Instagram, 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, écrire un résumé du site axé sur la stratégie |
| step-1-design.md | Étape 1 — écrire une antisèche de marque DESIGN.md (5 sections, 250-350 lignes ; chemin rapide de 50 lignes pour les publicités sociales de type panneau) |
| step-2-brief.md | Étape 2 — s'aligner sur le message, l'arc narratif et le public avec l'utilisateur |
| capabilities.md | Étapes 2 & 5 — inventaire complet de ce que HyperFrames peut faire (24 sections). Parcourir la TdM pendant le brief, approfondir les sections spécifiques pendant la construction |
| step-3-storyboard.md | Étape 3 — storyboard + script (combiné) avec point de contrôle 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, captures d'écran (adaptées à la durée vidéo), aperçu |
| techniques.md | Étapes 3 & 5 — 13 techniques d'animation primitives avec motifs de code (adapter, ne pas copier-coller) |
| html-in-canvas-patterns.md | Étape 5 — motifs de code complets pour les effets HTML-dans-Canvas (réside dans la compétence hyperframes) |