Que fait motion-graphics — point d'entrée dispatch ?
Confirmez la route avant l'étape 0. Cette compétence crée un motion graphic court, design-led, sans narration (le mouvement est le message ; ~moins de 10s, pas de voix-off). Un traitement plus long, multi-scène ou narré →
/general-video; une vidéo narrée d'un site web →/website-to-video; un expliqueur de sujet →/faceless-explainer; une promotion produit →/product-launch-video; des sous-titres sur des images existantes →/embedded-captions. Hors champ : données en direct / au moment du rendu, ou images qu'il ne peut pas capturer. Pas sûr entre motion-first et narré ? Lisez/hyperframesd'abord.
Un motion graphic court design-led. Actif d'abord : décidez la stratégie d'actifs et sourcez du 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 recherche ? + classifier + stratégie d'actifs | shot-plan.json (brouillon : catégorie, requêtes asset_needs, brief) | agents/director.md (Partie 1) |
| source ◇ | Bash — résolution média-use (sauter 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) + mise en page + 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 overlay) | renders/video.mp4 | Étape 5 |
| verify | Bash — lint / inspect -> sous-agent de réparation en cas d'échec | (corrections sur place) | agents/finalize.md |
◇ source s'exécute uniquement lorsque la catégorie choisie déclare des actifs. Les catégories de code/texte pur (par 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 fourche sépare les catégories en deux groupes ; ensuite la catégorie spécifique est choisie — pour les catégories pilotées par recherche, selon le type de contenu retourné par la recherche. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé réside 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 percutante / citation / titre, texte animé | blocs caption-* + règles d'animation |
stat | nombre unique / compteur + anneau | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | barres / lignes / camembert / course / % depuis les données | bloc data-chart |
logo-reveal | apparition de logo / bloc de marque (logo utilisateur) | logo-outro / rules/svg-path-draw |
lower-thirds | barres de nom / titre, incrustations, overlays sociaux | caption-* + blocs overlay du registre |
Catégories pilotées par recherche — recherche d'abord, puis anime par 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, incrustations) |
| article de presse | news | révélation de titre + carte source + incrustations 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) — uniquement nécessaires pour les catégories qui sourcent/génèrent des actifs via media-use :
| Clé | Utilisée pour | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | génération d'image (résolution media-use) | sauter génération / recherche uniquement |
| (fournisseurs de recherche asset_scout) | recherche d'actifs réels pour webpage/news/tweet + asset-fusion | la catégorie dégrade en sans actif |
Flux
Étape 0 — Initialisation
cwd 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 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 certaines sont obsolètes.
Contraintes : ne jamais hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre hyperframes/ dans 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)
Lancez un sous-agent. prompt = agents/director.md complet + ## 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 fourche)
- Non → choisir une catégorie de formulaire (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[](news / web / tweet / image ; requêtes à deux pôles). La catégorie pilotée par 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 de formulaire (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ;
- Écrire un brouillon
shot-plan.json(enveloppe + catégorie de formulaire choisie ou intention de recherche +asset_needs+ un paragraphe de brief de plan). 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 gelés locaux au projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories pilotées par recherche utilisent la recherche news/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 un fournisseur de recherche est indisponible, la catégorie revient à sans actif (notez-le dans context.log).
Étape 3 — Conception (sous-agent : Directeur Partie 2)
Lancez un sous-agent (prompt = agents/director.md Partie 2 + contexte de dispatch incluant 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/plans hyperframes-animation, la mise en page, le mouvement, les temps, et (pour asset-fusion) les element_positions + la palette de pipette. Finalise shot-plan.json (content.block + content.customize + contenu par catégorie).
Étape 4 — Construction (sous-agent : Constructeur, priorité à la réutilisation)
Lancez un sous-agent. prompt = agents/builder.md complet + contexte de dispatch (shot-plan.json, catalog-map.md, le module.md de la catégorie, references/motion-vocabulary.md, references/builder-contract.md). Réutilisation d'abord : npx hyperframes add <block> + personnaliser sur place ; n'écrire à la main que 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" + 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 overlay transparent : --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 lint/inspect, lancer le sous-agent de réparation (agents/finalize.md : snapshot QA + une passe de correction sur place + re-rendu). Ne jamais modifier une durée fixe lors de la réparation.
Rapport + aperçu optionnel
Rapportez la sortie finale (renders/video.mp4, ou la variante overlay .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 afin qu'il serve le fichier final :
(cd "$PROJECT_DIR" && npx hyperframes preview) # Interface Studio ; ou `npx hyperframes play` pour un lien partageable
Les indicateurs résident dans la compétence hyperframes-cli (references/preview-render.md).
Table 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)
- Justification actif d'abord : la source est chargée en amont et informe la conception du plan (le flux RWA : analyser → rechercher → réviser → composer). Les catégories pilotées par recherche (
webpage/news/tweet) etasset-fusions'appuient toutes sur la recherche media-use (news/web/tweet/image), qui est la lignée RWA documentée de media-use. - Réutilisation d'abord : 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 auuseCurrentFramede 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 # IR (sortie du Directeur) assets/ assets/index.md # sortie media-use (si sourcé) compositions/index.html # sortie du Constructeur renders/video.mp4 - Enregistrement : dans le routeur
hyperframes— ajouter l'intention "motion graphic court design-led" + description du Workflow ; retirer les déclencheurs de motion-graphics de/general-video; ajouter les arêtes inverses Do-NOT-use. Voirmotion-graphics-genre.md§5-7.