motion-graphics — point d'entrée de dispatch
Confirmer la route avant l'étape 0. Cette compétence réalise un court motion design graphique, non narré (le mouvement est le message ; ~moins de 10s, 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 vidéo explicative d'un sujet →/faceless-explainer; une promotion de produit →/product-launch-video; des sous-titres sur des séquences existantes →/embedded-captions. Hors périmètre : données en direct / au moment du rendu, ou séquences impossibles à capturer. Doute entre une pièce axée sur le mouvement ou une pièce narrée ? Lire/hyperframesd'abord.
Un court motion design graphique. Asset-first : décider la stratégie d'actifs et sourcer le matériel réel avant de concevoir le plan, puis concevoir le plan autour de ce que vous avez, puis composer 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 à ce répertoire.
| Phase | Exécution | Artefact principal | Flux détaillé |
|---|---|---|---|
| init | Bash | hyperframes.json | Étape 0 |
| plan | sous-agent — décider la recherche ? + classer + stratégie d'actifs | shot-plan.json (brouillon : catégorie, requêtes asset_needs, briefing) | agents/director.md (Partie 1) |
| source ◇ | Bash — résolution des médias (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 s'exécute uniquement lorsque la catégorie choisie déclare des actifs. Les catégories purement code/texte (ex. 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 bifurcation divise les catégories en deux groupes ; puis la catégorie spécifique est choisie — pour les catégories pilotées par la recherche, selon le type de contenu que la recherche retourne. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé se trouve dans references/motion-vocabulary.md (→ règles/blueprints hyperframes-animation + blocs de registre).
Catégories formelles — pas de recherche ; l'utilisateur fournit le contenu :
| Catégorie | Intention | S'appuie sur |
|---|---|---|
kinetic-type | ligne / citation / titre percutant, texte axé mouvement | blocs caption-* + règles d'animation |
stat | numéro unique / compteur héro + anneau | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | graphique barre / ligne / camembert / course / % à partir de données | bloc data-chart |
logo-reveal | sting logo / habillage de marque (logo utilisateur) | logo-outro / rules/svg-path-draw |
lower-thirds | barres nom / titre, légendes, superpositions sociales | caption-* + blocs de superposition du registre |
Catégories pilotées par la recherche — rechercher d'abord, puis animer selon le type de contenu (le chemin RWA) :
| Contenu retourné | Catégorie | Animation |
|---|---|---|
| page web / lien | webpage | animation de page web / UI (défilement, révélation, curseur, légendes) |
| article de presse | news | révélation de titre + carte source + légendes 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 (un brouillon est acceptable). kinetic-type porté depuis le prototype ; le reste suit.
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 (alternatives locales si non définies) — nécessaires uniquement pour les catégories qui sourcent/génèrent des actifs via media-use :
| Clé | Utilisée pour | Alternative par défaut |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | génération d'images (résolution media-use) | ignorer la génération / recherche seule |
| (fournisseurs asset_scout / recherche) | webpage/news/tweet + recherche d'actifs réels asset-fusion | la catégorie se dégrade en version sans actifs |
Flux
Étape 0 — Initialisation
le répertoire de travail (cwd) est la racine de l'espace de travail de l'agent ; écrire tous les artefacts sous PROJECT_DIR = videos/<nom-du-projet>/. <nom-du-projet> : utiliser le répertoire donné par l'utilisateur, sinon un nom court en kebab-case dérivé de l'intention (<sujet>-motion). Pas le nom de base de l'espace de travail ni 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 l'une d'elles est obsolète.
Contraintes : ne jamais exécuter 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 : Director Partie 1)
Lancer un sous-agent. invite = contenu complet de agents/director.md + ## Contexte de dispatch (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 bifurcation)
- Non → choisir une catégorie formelle (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ;
asset_needs: []. - Oui → émettre un plan de recherche dans
asset_needs[](actualité / 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 retourné à l'étape 2, et finalisée à l'étape 3.
- Non → choisir une catégorie formelle (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ;
- Écrire un brouillon de
shot-plan.json(enveloppe + catégorie formelle choisie ou intention de recherche +asset_needs+ un briefing d'un paragraphe). Schéma :references/shot-plan-ir.md.
Validation : [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.
Étape 2 — Source ◇ (Bash : media-use, conditionnel)
Si shot-plan.json.asset_needs n'est pas vide, résoudre les actifs (recherche / génération / récupération → chemins locaux figés dans le projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories pilotées par la recherche utilisent la recherche d'actualités/web/tweet/image). Si asset_needs est vide, passer à 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égradation gracieuse : si une recherche/un fournisseur est indisponible, la catégorie revient à une version sans actifs (le noter dans context.log).
Étape 3 — Conception (sous-agent : Director Partie 2)
Lancer un sous-agent (invite = agents/director.md Partie 2 + contexte de dispatch 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 : choisir le(s) bloc(s) catalogue + les règles/blueprints hyperframes-animation, la disposition, le mouvement, les temps, et (pour asset-fusion) les element_positions + la palette de prélèvement de couleurs. Finalise shot-plan.json (content.block + content.customize + contenu par catégorie).
Étape 4 — Construction (sous-agent : Builder, priorité à la réutilisation)
Lancer un sous-agent. invite = contenu complet de agents/builder.md + contexte de dispatch (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> + personnaliser sur place ; n'écrire à la main que les lacunes + l'ouverture de fusion d'actifs. Produire compositions/index.html respectant le contrat HF (timeline GSAP en pause sur window.__timelines, class="clip" + ids 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 .)
code de sortie 0 → terminé. En cas d'erreurs de lint/inspect, lancer le sous-agent de réparation (agents/finalize.md : QA instantané + un passage de correctif sur place + re-rendu). Ne jamais modifier une durée fixe lors de la réparation.
Rapport + aperçu optionnel
Signaler la sortie finale (renders/video.mp4, ou la variante .webm / .mov pour superposition) + durée. Ne pas ouvrir d'aperçu pendant l'exécution. N'en proposer un que sur demande, lancé 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 options 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 (source) |
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)
- Raisonnement Asset-first : le sourcing est réalisé 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 sur la recherche media-use (actualités/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 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 classifieur dansagents/director.md+ sa ligne danscatalog-map.md; le pipeline de phases est inchangé. - Structure du répertoire :
videos/<nom-du-projet>/ hyperframes.json context.log shot-plan.json # le RI (sortie du Director) assets/ assets/index.md # sortie media-use (si sourcé) compositions/index.html # sortie du Builder renders/video.mp4 - Enregistrement : dans le routeur
hyperframes— ajouter l'intention « court motion design graphique conçu » + la description du Workflow ; retirer les déclencheurs motion-graphics de/general-video; ajouter les arêtes inverses « NE PAS UTILISER ». Voirmotion-graphics-genre.md§5-7.