motion-graphics — point d'entrée du dispatch
Confirmez la route avant l'étape 0. Cette compétence réalise un court motion graphic, design-led, sans narration (le mouvement est le message ; ~moins de 10s, pas de voix-off). Un projet plus long, multi-scènes ou narré →
/general-video; une vidéo narrée d'un site web →/website-to-video; un sujet explicatif →/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'elle ne peut pas capturer. Pas sûr si c'est du motion-first ou du narré ? Lisez/ hyperframesd'abord.
Un court motion graphic design-led. Asset-first : décidez la stratégie d'assets et obtenez 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 ? + classer + stratégie d'assets | shot-plan.json (brouillon: catégorie, requêtes asset_needs, brief) | agents/director.md (Partie 1) |
| source ◇ | Bash — résoudre les médias (ignorer si asset_needs est vide) | assets/ + assets/index.md | phases/source/guide.md |
| design | sous-agent — conception du plan autour des assets résolus | shot-plan.json (final: bloc(s) + mise en page + mouvement + positions) | agents/director.md (Partie 2) |
| build | sous-agent — composition avec priorité à 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 | (corrections sur place) | agents/finalize.md |
◇ source s'exécute uniquement lorsque la catégorie choisie déclare des assets. Les catégories de code/texte purs (ex. kinetic-type, la plupart des charts/stat) ont asset_needs: [] et passent directement de la planification à la conception.
Catégories — séparées par la décision de recherche
La première décision du plan est : cela nécessite-t-il une recherche ? Cette bifurcation sépare les catégories en deux groupes ; ensuite, la catégorie spécifique est choisie — pour les catégories basées sur la recherche, par 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é 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 | Repose sur |
|---|---|---|
kinetic-type | ligne/accroche/titre percutant, texte mouvant | blocs caption-* + règles d'animation |
stat | nombre héroïque unique / compteur + cercle | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | barres / lignes / camembert / 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, appels, superpositions sociales | caption-* + blocs de superposition du registre |
Catégories basées sur la recherche — chercher 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, appels) |
| article de presse | news | révélation de titre + carte source + appels de faits clés |
| tweet | tweet | carte tweet animée |
| image / entité | asset-fusion | la géométrie de l'asset devient le graphique (fusion diégétique RWA) |
Ordre de construction : un à la fois, priorité à la couverture (le brut 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 (fallbacks locaux si non définies) — nécessaires uniquement pour les catégories qui génèrent/obtiennent des assets 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 de recherche asset_scout) | recherche d'assets réels webpage/news/tweet + asset-fusion | la catégorie se dégrade en version sans asset |
Flux
Étape 0 — Initialisation
Le répertoire de travail courant 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 dossier 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 timestamp.
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 faire 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)
Envoyez un sous-agent. l'invite = le agents/director.md complet + ## Contexte du 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 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[](actualité / web / tweet / image ; requêtes bipolaires). La catégorie basée sur 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 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 brief de plan 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 assets (recherche / génération / récupération → chemins locaux gelés du projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories basées sur 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/fournisseur est indisponible, la catégorie revient à la version sans asset (le noter dans context.log).
Étape 3 — Conception (sous-agent : Directeur Partie 2)
Envoyez un sous-agent (invite = agents/director.md Partie 2 + contexte du 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 assets disponibles : choisir le(s) bloc(s) du catalogue + les règles/plans hyperframes-animation, la mise en page, le mouvement, les temps forts, 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 : Builder, priorité à la réutilisation)
Envoyez un sous-agent. invite = le agents/builder.md complet + contexte du 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 <bloc> + personnaliser sur place ; ne faire à la main que les lacunes + l'affordance de fusion d'assets. 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 .)
exit 0 → terminé. En cas d'erreurs de lint/inspect, envoyer le sous-agent de réparation (agents/finalize.md : snapshot QA + une passe de correction sur place + nouveau rendu). Ne jamais modifier une durée fixée lors de la réparation.
Rapport + aperçu optionnel
Rapporter la sortie finale (renders/video.mp4, ou la variante de superposition .webm / .mov) + durée. N'ouvrez pas d'aperçu pendant l'exécution. N'en proposer un que sur demande, démarré après le rendu pour servir le fichier final :
(cd "$PROJECT_DIR" && npx hyperframes preview) # Interface Studio ; ou `npx hyperframes play` pour un lien partageable
Les drapeaux vivent 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 | Rapporter + arrêter |
Notes de conception (mainteneurs — l'exécution ne lit pas ceci)
- Raisonnement Asset-first : la recherche est chargée en amont et informe la conception du plan (le flux RWA : analyser → chercher → examiner → composer). Les catégories basées sur la recherche (
webpage/news/tweet) etasset-fusions'appuient toutes deux 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'équivalent dans l'écosystème des templates générés par LLM est "composer des blocs du 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é. - 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— ajouter l'intention "court motion graphic design-led" + la 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.