motion-graphics — entrée de répartition
Confirmez la route avant l'étape 0. Cette compétence réalise un graphisme animé court, axé sur le design et sans narration (le mouvement est le message ; ~moins de 10 s, pas de voix off). Un traitement plus long, multi-scènes ou narré →
/general-video; une vidéo narrée d'un site Web →/website-to-video; une explication de sujet →/faceless-explainer; une promotion de produit →/product-launch-video; des légendes sur des séquences existantes →/embedded-captions. Hors de portée: données en direct / au moment du rendu, ou séquences qu'il ne peut pas capturer. Vous n'êtes pas sûr qu'il s'agisse d'un mouvement d'abord ou d'une narration ? Lisez/hyperframesen premier.
Un graphisme animé court et axé sur le design. D'abord les actifs : décidez de la stratégie d'actifs et trouvez le matériel réel avant de concevoir le plan, puis concevez le plan autour de ce que vous avez, puis composez en réutilisant les capacités du catalogue. Tous les artefacts vont dans PROJECT_DIR = videos/<nom-du-projet>/ (créé à l'étape 0) ; tous les chemins ci-dessous sont relatifs à celui-ci.
| Phase | Exécution | Artefact principal | Flux détaillé |
|---|---|---|---|
| init | Bash | hyperframes.json | Étape 0 |
| plan | sous-agent — décider de la recherche ? + classer + stratégie d'actifs | shot-plan.json (brouillon : catégorie, requêtes asset_needs, brief) | agents/director.md (Partie 1) |
| source ◇ | Bash — résolution media-use (ignorer si asset_needs est vide) | assets/ + assets/index.md | phases/source/guide.md |
| design | sous-agent — conception du plan autour des actifs résolus | shot-plan.json (final : bloc(s) + disposition + mouvement + positions) | agents/director.md (Partie 2) |
| build | sous-agent — composition priorisant la réutilisation | compositions/index.html | agents/builder.md |
| render | Bash — hyperframes render (MP4, ou --format webm/mov pour superposition) | renders/video.mp4 | Étape 5 |
| verify | Bash — lint / inspect -> sous-agent de réparation en cas d'échec | (correctifs sur place) | agents/finalize.md |
◇ source ne s'exécute que lorsque la catégorie choisie déclare des actifs. Les catégories de code/texte pures (par exemple kinetic-type, la plupart des charts/stat) ont asset_needs: [] et passent directement de la planification à la conception.
Catégories — divisées par la décision de recherche
La première décision de plan est : cela nécessite-t-il une recherche ? Cette fourche divise les catégories en deux groupes ; ensuite, la catégorie spécifique est choisie — pour les catégories pilotées par la recherche, par le type de contenu que la recherche renvoie. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé vit dans references/motion-vocabulary.md (→ règles/plans hyperframes-animation + blocs de registre).
Catégories de formulaire — pas de recherche ; l'utilisateur fournit le contenu :
| Catégorie | Intention | S'appuie sur |
|---|---|---|
kinetic-type | ligne / citation / titre percutant, texte axé sur le mouvement | blocs caption-* + règles d'animation |
stat | un seul chiffre / compteur héroïque + anneau | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | graphique à barres / lignes / circulaire / course / % à partir de données | bloc data-chart |
logo-reveal | logo sting / habillage de marque (logo utilisateur) | logo-outro / rules/svg-path-draw |
lower-thirds | barres de nom / titre, interpellations, superpositions sociales | caption-* + blocs de superposition du registre |
Catégories pilotées par la recherche — recherchez d'abord, puis animez par type de contenu (chemin RWA) :
| Contenu renvoyé | Catégorie | Animation |
|---|---|---|
| page Web / lien | webpage | Animation de page Web / UI (défilement, révélation, curseur, interpellations) |
| article de presse | news | Révélation de titre + carte source + interpellations de faits clés |
| tweet | tweet | Carte tweet animée |
| image / entité | asset-fusion | La géométrie de l'actif devient le graphique (fusion diégétique RWA) |
Ordre de construction : un à la fois, priorité à la couverture (l'ébauche est acceptable). kinetic-type porté du prototype ; les autres suivent.
Prérequis
macOS Apple Silicon ou Linux x64. Outils système : brew install node ffmpeg. npx hyperframes doctor une fois. Rendu GPU macOS : export PRODUCER_BROWSER_GPU_MODE=hardware.
Clés optionnelles (fallbacks locaux si non définies) — nécessaires uniquement pour les catégories qui sourcent/génèrent des actifs via media-use :
| Clé | Utilisé pour | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | génération d'images (résolution media-use) | ignorer la génération / recherche uniquement |
| (fournisseurs asset_scout / recherche) | recherche d'actifs réels webpage/news/tweet + asset-fusion | la catégorie dégrade sans actifs |
Flux
Étape 0 — Initialisation
Le répertoire de travail actuel est la racine de l'espace de travail de l'agent ; écrivez tous les artefacts sous PROJECT_DIR = videos/<nom-du-projet>/. <nom-du-projet>: utilisez le répertoire donné par l'utilisateur, sinon un nom court en kebab-case à partir de l'intention (<sujet>-motion). Pas le nom de base de l'espace de travail ou un horodatage.
Uniquement lorsque $PROJECT_DIR/hyperframes.json est absent :
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<nom-du-projet>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank
init vérifie les compétences installées par rapport aux dernières sur GitHub et met à jour l'ensemble global si certaines sont obsolètes.
Contraintes : ne jamais hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre hyperframes/ à l'intérieur de PROJECT_DIR ; chaque commande Bash (maître + sous-agents) est un sous-shell (cd "$PROJECT_DIR" && ...) — jamais de cd nu.
Étape 1 — Planification (sous-agent : Directeur Partie 1)
Déléguez un sous-agent. invite = agents/director.md complet + ## Contexte de répartition (SKILL_DIR / PROJECT_DIR / la demande de l'utilisateur / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Il doit :
- Décider : cela nécessite-t-il une recherche ? (la première fourche)
- Non → choisissez une catégorie de formulaire (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ;
asset_needs: []. - Oui → émettez un plan de recherche dans
asset_needs[](presse / web / tweet / image ; requêtes bipolaires). La catégorie pilotée par la recherche spécifique (webpage / news / tweet / asset-fusion) est confirmée par le type de contenu renvoyé à l'étape 2, et finalisée à l'étape 3.
- Non → choisissez une catégorie de formulaire (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ;
- Écrivez un brouillon
shot-plan.json(enveloppe + catégorie de formulaire choisie ou intention de recherche +asset_needs+ un bref paragraphe de description du plan). Schéma :references/shot-plan-ir.md.
Validation : [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.
Étape 2 — Sourceage ◇ (Bash : media-use, conditionnel)
Si shot-plan.json.asset_needs n'est pas vide, résolvez les actifs (recherche / génération / récupération → chemins locaux figés du projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories pilotées par la recherche utilisent la recherche presse/web/tweet/image). Si asset_needs est vide, passez à l'étape 3.
# illustratif — voir phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
Dégradez avec élégance : si une recherche/un fournisseur est indisponible, la catégorie revient sans actifs (notez-le dans context.log).
Étape 3 — Conception (sous-agent : Directeur Partie 2)
Déléguez un sous-agent (invite = agents/director.md Partie 2 + contexte de répartition incluant le assets/index.md résolu si l'étape 2 a été exécutée + catalog-map.md). Il conçoit le plan autour des actifs disponibles : choisissez le(s) bloc(s) de catalogue + les règles/plans hyperframes-animation, la disposition, le mouvement, les battements, et (pour asset-fusion) les element_positions + la palette de la pipette. Finalise shot-plan.json (content.block + content.customize + contenu par catégorie).
Étape 4 — Construction (sous-agent : Builder, priorité à la réutilisation)
Déléguez un sous-agent. invite = agents/builder.md complet + contexte de répartition (shot-plan.json, catalog-map.md, le module.md de la catégorie, references/motion-vocabulary.md, references/builder-contract.md). Priorité à la réutilisation : npx hyperframes add <block> + personnalisation sur place ; rédigez manuellement uniquement les lacunes + l'affordance de fusion d'actifs. Sortie compositions/index.html respectant le contrat HF (timeline GSAP en pause sur window.__timelines, class="clip" + identifiants stables, tl.seek(0), déterministe).
Étape 5 — Rendu (Bash)
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# variante superposition transparente : --format webm (ou mov)
Étape 6 — Vérification (Bash → sous-agent de réparation en cas d'échec)
(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)
exit 0 → terminé. En cas d'erreurs de lint/inspect, déléguez le sous-agent de réparation (agents/finalize.md : QA d'instantané + un passage de correctif sur place + nouveau rendu). Ne modifiez jamais une durée fixe lors de la réparation.
Rapport + aperçu optionnel
Rapportez la sortie finale (renders/video.mp4, ou la variante de superposition .webm / .mov) + la durée. N'ouvrez pas d'aperçu pendant l'exécution. Proposez-en un uniquement sur demande, démarré après le rendu pour qu'il serve le fichier final :
(cd "$PROJECT_DIR" && npx hyperframes preview) # Interface Studio ; ou `npx hyperframes play` pour un lien partageable
Les indicateurs se trouvent dans la compétence hyperframes-cli (references/preview-render.md).
Tableau de reprise
| État | Continuer depuis |
|---|---|
pas de shot-plan.json | Étape 1 (planification) |
shot-plan.json a asset_needs, pas de assets/ | Étape 2 (sourceage) |
shot-plan.json final, pas de compositions/index.html | Étape 3/4 (conception+construction) |
compositions/index.html existe, pas de renders/video.mp4 | Étape 5 (rendu) + Étape 6 |
renders/video.mp4 existe | Rapport + arrêt |
Notes de conception (mainteneurs — l'exécution ne lit pas ceci)
- Raison d'être des actifs d'abord : le sourçage est effectué en amont et informe la conception du plan (le flux RWA : analyser → rechercher → examiner → composer). Les catégories pilotées par la recherche (
webpage/news/tweet) etasset-fusions'appuient toutes deux sur la recherche media-use (presse/web/tweet/image), qui est la lignée RWA documentée de media-use. - Priorité à la réutilisation : l'analogue dans l'écosystème des modèles générés par LLM est « composer des blocs de catalogue + règles
hyperframes-animation». La timeline GSAP en pause de HF équivaut àuseCurrentFramede Remotion. - Contrat du module de catégorie : un
categories/<id>/module.md(planification + construction), partageantreferences/motion-vocabulary.md(+ évaluation optionnelle). Ajouter une catégorie = déposer le dossier + enregistrer sa ligne de classification dansagents/director.md+ sa ligne danscatalog-map.md; le pipeline de phase est intact. - Forme du répertoire :
videos/<nom-du-projet>/ hyperframes.json context.log shot-plan.json # l'IR (sortie du Directeur) assets/ assets/index.md # sortie de media-use (si sourcé) compositions/index.html # sortie du Builder renders/video.mp4 - Enregistrement : dans le routeur
hyperframes— ajoutez l'intention « graphisme animé court axé sur le design » + la description du workflow ; retirez les déclencheurs motion-graphics de/general-video; ajoutez les arêtes inversées « NE PAS UTILISER ». Voirmotion-graphics-genre.md§5-7.