Que fait HyperFrames — Lire ceci en premier ?
Commencez ici pour toute tâche HyperFrames — surtout en l'absence de configuration d'agent de projet (CLAUDE.md / AGENTS.md / .cursorrules). Carte des capacités + routeur vidéo ci-dessous.
Carte des capacités — quelle compétence pour quelle intention
| Vous voulez… | Allez vers |
|---|---|
| Faire une vidéo (à partir d'une URL, d'un brief, d'un sujet, d'une PR GitHub, d'un footage existant ou d'un seul élément à animer) | le routeur vidéo ci-dessous (§ Routage vidéo) |
Créer / éditer une composition HTML — le contrat data-*, clips, pistes, sous-compositions, variables | /hyperframes-core |
| Animer — règles de mouvement atomiques, blueprints de scène, transitions, adaptateurs runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Direction créative — design.md, palettes, typographie, narration, planification des beats, réactif à l'audio | /hyperframes-creative |
| Prétraitement média — voix off TTS, musique de fond, transcription, suppression d'arrière-plan, sous-titres | /hyperframes-media |
| Boucle de développement CLI — init, lint, valider, inspecter, prévisualiser, rendre, publier, doctor | /hyperframes-cli |
Installer des blocs / composants du registre (hyperframes add) | /hyperframes-registry |
Le contrat de création de composition (tout élément temporel a besoin de
data-start/data-duration/data-track-index; les éléments temporels ont besoin declass="clip"; les timelines GSAP sont mises en pause et enregistrées surwindow.__timelines; logique déterministe uniquement — pas deDate.now()/Math.random()/ réseau) n'est pas dupliqué ici — il vit dans/hyperframes-core. Lisez-le avant d'écrire du HTML de composition.
Ce qu'HyperFrames ne peut pas faire — vérifiez ceci en premier
HyperFrames crée une composition HTML et la rend en MP4 à partir du code. Ce modèle a des limites strictes. Une requête qui dépasse l'une d'elles n'est pas un choix de routage — elle est hors de portée, donc déclinez (ou orientez vers le bon outil) au lieu d'essayer un workflow. Ces limites découlent de l'architecture, pas d'une simple demande :
- Le rendu est déterministe et autonome. Chaque valeur, ressource et texte est intégré au moment de la création ; le rendu n'effectue aucun appel réseau et aucune extraction de données en direct / au moment du rendu (règle fondamentale : pas de
Date.now()/Math.random()/ réseau). « Rendre les chiffres en direct au moment du rendu » est hors de portée — récupérez les données une fois au moment de la création et intégrez-les, ou déclinez. - La vidéo existante est superposée, jamais éditée. HyperFrames compose des images par-dessus un clip source —
/embedded-captionsajoute une couche de sous-titres,/graphic-overlaysajoute des cartes graphiques conçues (tiers inférieurs, encadrés de données, titres) — et le clip reste inchangé en dessous, mais il ne retraite pas le flux vidéo encodé. Modifier le footage lui-même (son timing, sa couleur, son cadrage, son ordre ou son audio) relève de l'édition de type NLE et est hors de portée. - L'importation Remotion est à sens unique.
/remotion-to-hyperframestraduit le code source du framework Remotion en HyperFrames. Il n'y a pas de traduction inverse (HyperFrames → Remotion, ou → tout autre framework — hors de portée), et une source React / animation web non-Remotion n'a pas de source Remotion à traduire — recréez-la via/general-video. - Il ne peut pas produire des entrées qu'il ne possède pas. Pas d'enregistrement d'écran / session, pas de capture caméra, pas de génération d'avatar parlant / synchronisé labialement par IA. Si le footage ou la ressource n'existe pas encore, HyperFrames ne peut pas le créer — demandez à l'utilisateur de le fournir (ou d'utiliser le bon outil de capture) d'abord.
Tout le reste — une vidéo à partir d'une URL, d'un brief, d'un sujet, d'une PR, d'un footage à annoter ou d'un seul élément à animer — est dans le périmètre ; routez-le ci-dessous.
Routage vidéo
Cette section connaît UNIQUEMENT les workflows de haut niveau. Elle ne charge pas les phases internes des workflows, les compétences de domaine (hyperframes-* — voir la carte des capacités ci-dessus) ou les références techniques.
Table de décision
Le type d'ENTRÉE (intention) est l'axe principal ; la longueur de SORTIE est seulement un plafond, pas un verrou. Pour une entrée correspondante, les workflows spécialisés gèrent tout jusqu'à ~3 min — quel workflow vous entrez est décidé par l'intention (le type d'entrée, et pour le texte, le sujet), pas par la durée. La durée compte seulement à l'extrémité haute : un contenu vraiment plus long (un tutoriel de 3-5 min, une analyse approfondie de 5 min+) est un registre différent et route vers /general-video. Dans la bande ≤~3 min, un troisième axe sépare les deux workflows alimentés par du texte — le sujet : un produit qui est commercialisé vs un sujet qui est expliqué (voir la règle de désambiguïsation à l'étape 3 ci-dessous).
| Durée / Entrée | Lancement produit (URL / brief / script) | Site web général / URL | PR GitHub / changement de code | Sujet / article / notes (pas de produit, pas d'URL) | Vidéo existante (talking-head) † |
|---|---|---|---|---|---|
| ≤ ~3 min | /product-launch-video | /website-to-video | /pr-to-video | /faceless-explainer | /embedded-captions · /graphic-overlays † |
| Tutoriel 3-5 min | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| Analyse approfondie 5 min+ | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| Statique / boucle | /general-video | /general-video | /general-video | /general-video | /general-video |
Couverture actuelle : la bande ≤ ~3 min a des workflows dédiés pour les entrées lancement-produit / site-web-général / PR-GitHub / sujet (une URL se divise en type puis intention — voir l'étape 3), et la colonne vidéo existante est couverte à n'importe quelle durée — par /embedded-captions (sous-titres / légendes) ou /graphic-overlays (incrustations graphiques conçues), répartis par intention (voir l'étape 2). Chaque autre case est /general-video — le flux général de création de composition HTML (indépendant de l'entrée et de la durée) : tout ce qui est plus long que ~3 min (les lignes 3-5 min / 5 min+) et chaque format statique / boucle. Le routeur n'aboutit jamais à une impasse sur une vidéo créable ; la seule véritable réponse « général / aucun » est une demande en dehors d'HyperFrames lui-même (par exemple, l'édition de type NLE d'un fichier vidéo fini — re-timing, recoloration, recadrage, réorganisation, audio).
† Le footage existant se répartit par intention, pas par durée. Sous-titres / légendes → /embedded-captions ; incrustations graphiques conçues / habillage — tiers inférieurs, encadrés de données, cartes titrées, pull-quotes → /graphic-overlays. Les deux superposent le clip, qui reste inchangé en dessous ; aucun n'édite le footage lui-même.
Court-circuit de genre (précède le tableau). Un motion graphic court (~moins de 10s), sans narration, axé sur le design — typographie cinétique, un stat / point de graphique, un logo sting, un tier inférieur / incrustation, ou un tweet / titre / surbrillance de page animé — route vers /motion-graphics quel que soit le type d'entrée. C'est un genre de SORTIE, pas un type d'entrée, donc il prend le pas sur le tableau des types d'entrées ci-dessus lorsque la demande est clairement axée sur le mouvement sans narration (voir l'étape 2). Un traitement plus long ou narré route selon le type d'entrée, ou /general-video.
Migration d'une composition existante (cas spécial)
Le tableau ci-dessus concerne la création d'une vidéo à partir d'une entrée. Un workflow se situe en dehors : si l'utilisateur demande explicitement de porter / convertir / migrer une composition Remotion (React) existante dans HyperFrames → /remotion-to-hyperframes. C'est une traduction de source, pas une création à partir d'une entrée, donc elle n'a pas de case ENTRÉE × DURÉE. Routez ici UNIQUEMENT sur un langage de migration explicite (« porte mon projet Remotion », « convertis cette comp Remotion », « réécris ça en HyperFrames ») — une mention passagère de Remotion n'est pas un déclencheur ; utilisez par défaut le tableau de création ou /hyperframes-core.
Procédure de routage
- Déterminez le type d'ENTRÉE + la longueur cible. Le routage a besoin de savoir ce que la vidéo raconte— son sujet et son entrée. Si le sujet lui-même n'est pas spécifié (par exemple « fais une vidéo sur notre truc » sans URL, produit nommé, sujet ou ressource de travail), ou si le type d'entrée est inconnu, demandez avant d'entrer dans un workflow — clarifiez d'abord ; n'invoquez pas un Skill de workflow puis ne demandez pas, car s'engager dans un workflow est en soi la décision de routage. Posez au maximum 2 questions de clarification :
- « Quelle est votre entrée — un produit (URL ou brief), un site web général / URL, une PR GitHub / un changement de code, un sujet ou article à expliquer, ou une vidéo talking-head existante à sous-titrer ? »
- « Longueur cible — environ 3 minutes ou moins, ou plus long (un tutoriel de 3-5 min / une analyse approfondie de 5 min+) ? »
- Valeurs par défaut des spécifications — déclarez, ne demandez pas (celles-ci n'AFFECTENT PAS la route, donc ne bloquez jamais le routage dessus) : rapport hauteur/largeur 16:9 (le moteur supporte également le 9:16 vertical — passez seulement si l'utilisateur nomme une destination verticale comme TikTok / Reels / Shorts) ; langue de la narration / du sous-titrage = celle de l'utilisateur. Confirmez seulement si l'utilisateur s'y oppose ; le workflow choisi re-confirme ses propres spécificités à son étape 0.
- Choisissez par type d'ENTRÉE (intention) d'abord ; la durée n'est qu'un plafond, pas un verrou.
- Motion graphic court axé sur le design (court-circuit de genre, précède le tableau d'entrée) — le mouvement lui-même est le message : typographie cinétique, un stat / compteur de nombre, un point de graphique, un logo sting, un tier inférieur / incrustation, ou un tweet / titre / surbrillance de page animé ; généralement moins de ~10s, pas de narration / voix off →
/motion-graphics. C'est un genre de SORTIE, pas un type d'entrée — lorsque la demande est clairement un court morceau animé sans narration, routez ici quel que soit le type d'entrée. Un traitement plus long ou narré du même matériel n'est PAS cela (routez selon le type d'entrée, ou/general-video). - Vidéo talking-head existante (l'utilisateur a un clip et veut y ajouter quelque chose) → répartissez par intention, à n'importe quelle durée (le type d'entrée l'emporte sur la durée) : sous-titres / légendes (les mots parlés sous forme de texte lisible) →
/embedded-captions; incrustations graphiques conçues — tiers inférieurs, encadrés de données, fiches d'info titrées, pull-quotes, un montage habillé graphiquement →/graphic-overlays. (Éditer le footage lui-même — re-timing, recolorier, recadrer, réordonner, audio — est de type NLE et hors de portée ; voir § Ce qu'HyperFrames ne peut pas faire.) - PR GitHub / changement de code (un lien
github.com/<propriétaire>/<dépôt>/pull/<N>, une référencepropriétaire/dépôt#N, ou « cette PR ») →/pr-to-video(jusqu'à ~3 min). - Sinon (URL produit / brief / texte de sujet) : l'intention choisit le workflow via l'étape 3, et elle gère tout ce qui est jusqu'à ~3 min — un court promo de 15-30 s et un explicateur de ~100 s se routent tous les deux par intention, pas par durée. Routez vers
/general-video(le fallback indépendant de la durée — voir l'étape 4) uniquement lorsque la cible est clairement plus longue que ~3 min (un tutoriel de 3-5 min, une analyse approfondie de 5 min+). Ne forcez jamais un contenu vraiment long dans un workflow ≤~3 min — l'intention décide dans la bande,/general-videocouvre le reste.
- Motion graphic court axé sur le design (court-circuit de genre, précède le tableau d'entrée) — le mouvement lui-même est le message : typographie cinétique, un stat / compteur de nombre, un point de graphique, un logo sting, un tier inférieur / incrustation, ou un tweet / titre / surbrillance de page animé ; généralement moins de ~10s, pas de narration / voix off →
- Désambiguïsez les entrées URL / texte ≤~3 min (le partage d'intention). Deux partages :
- Type d'URL + intention — une URL ne gagne plus automatiquement pour PLV ; son type puis son intention décident : un lien PR GitHub (
.../pull/<N>,propriétaire/dépôt#N, « cette PR ») →/pr-to-video; sinon, une URL de site web se répartit par intention — commercialisation / lancement / promotion d'un produit ou SaaS spécifique →/product-launch-video; un site général → vidéo (visite du site, portfolio / blog / vitrine de page d'accueil, un clip social à partir des propres visuels du site, ou simplement « transforme ce site en vidéo ») →/website-to-video. Les deux explorent avec Chrome headless ; les URL de PR sont lues viagh. Lorsqu'il n'est vraiment pas clair qu'une URL de site est un lancement produit ou une vidéo de site général, posez une question. - Produit vs sujet (texte, pas d'URL) — la question décisive est ce que la vidéo raconte, pas le format d'entrée :
- Un produit / entreprise / SaaS / application / site web spécifique qui est commercialisé, lancé ou promu →
/product-launch-video. - Un concept / sujet / article / comment-quelque-chose-fonctionne qui est expliqué, sans produit et sans URL →
/faceless-explainer. - Départageurs : Un libellé « Promouvoir / lancer / vendre / notre produit » → PLV. « Expliquer / enseigner / comment X fonctionne / qu'est-ce que X » sans produit → faceless. Le style livré pour faceless est toujours
pin-and-paper. - Un site nommé sans URL collée est toujours PLV. Un script qui mentionne un produit ou son site web (« notre site est acme.io », « promeut ») route vers PLV même sans lien cliquable — PLV peut chercher le site sur le web et l'explorer pour les ressources de la marque (sauf si l'utilisateur se désengage, → mode préréglé sans capture). Ne pas coller l'URL n'en fait pas un travail faceless / sans capture. Le choix verbeux-vs-restructuration pour un script fourni est interne à PLV et ne change jamais la route.
- Indices contradictoires → demandez, ne devinez pas. Si la source fournie est le propre matériel marketing d'un produit (sa page d'accueil, un article promotionnel sur leur plateforme) mais que l'utilisateur demande explicitement de supprimer la promotion — un explicateur neutre du concept sous-jacent, pas une pub — traitez-le comme vraiment ambigu (est-ce que la vidéo
- Un produit / entreprise / SaaS / application / site web spécifique qui est commercialisé, lancé ou promu →
- Type d'URL + intention — une URL ne gagne plus automatiquement pour PLV ; son type puis son intention décident : un lien PR GitHub (
…
[tronqué pour la traduction]