Le visuel d'abord. Le texte ensuite. Chaque nom gagne un actif réel.
Deux lois. Elles s'appliquent à chaque séquence et à chaque workflow.
Loi 1 — Le visuel d'abord, le texte ensuite
Les gens ne lisent pas. Ils scannent. Un graphique animé est une image qui bouge, pas un diaporama avec animation dessus. Le mécanisme porte le sens ; les mots ne font que l'étiqueter.
Le test, appliqué à chaque séquence avant de la construire :
Supprimez chaque mot du cadre. L'idée passe-t-elle encore ? Si non, le visuel ne fait pas encore son travail — corrigez le visuel, n'ajoutez pas de mots.
Le texte est un élément de support. Il nomme ce que le spectateur regarde déjà. Il ne porte jamais une affirmation que l'image ne fait pas déjà.
À faire
- Montrez le mécanisme en mouvement : route, transforme, remplit, compte, trie, converge, bifurque.
- Utilisez de vrais logos, de vraies interfaces utilisateur, de vrais écrans comme preuve.
- Une étiquette courte par objet majeur — 1 à 3 mots.
- Un chiffre principal, uniquement lorsque la narration le prononce.
À ne pas faire
- Coller la narration à l'écran. Les légendes font deux lignes maximum, jamais de paragraphes.
- Construire une liste à puces, une carte d'ordre du jour ou un mur de cartes de texte. Une liste est une constellation ou un hub convergent, pas des puces empilées.
- Utiliser une carte de texte parce que l'idée était difficile à visualiser. C'est le moment de travailler plus dur sur le visuel, pas d'abandonner et de taper.
- Laisser une étiquette énoncer quelque chose que le mécanisme ne montre pas.
Rapport d'attention : budgettez environ 80 % de votre effort de construction sur l'objet en mouvement et 20 % sur le texte. Si vous avez fait l'inverse, la séquence est erronée.
Loi 2 — Chaque entité nommée gagne un actif réel sourcé
Lorsque la narration nomme quoi que ce soit qui existe en ligne — une entreprise, un produit, un outil, un site web, un dépôt GitHub, un modèle, un framework — allez chercher la chose réelle et mettez-la à l'écran.
Les entités nommées sont des preuves. Un spectateur qui entend « Clay » et voit la marque réelle de Clay vous croit. Un spectateur qui entend « Clay » et voit le mot « Clay » en Inter ne vous croit pas.
Ne dessinez jamais une boîte générique, n'inventez pas une marque, n'approchez pas un logo de mémoire, et ne laissez pas le nom en simple texte quand un actif réel existe.
Quoi sourcer, par ordre de valeur
| Entité nommée | Obtenez ceci |
|---|---|
| Une entreprise ou un outil | Son vrai logo en couleur |
| Un produit avec une interface utilisateur | Un véritable écran de cette interface, plus le logo |
| Un site web | Une capture du site réel — npx hyperframes capture <url> |
| Un dépôt GitHub | L'avatar/marque propre du dépôt, et le README ou la surface du dépôt |
| Un modèle / framework | La marque du fournisseur (Anthropic, OpenAI, …) |
| Une personne | Seulement avec un actif fourni. Ne récupérez pas la photo de quelqu'un. |
Comment sourcer
Vérifiez d'abord la bibliothèque figée. Les marques vérifiées se trouvent dans library/assets/logos/ (provenance dans son SOURCES.md). Ne récupérez jamais ce qui est déjà figé et vérifié.
Logos — utilisez le résolveur, ne chassez pas à la main :
cat > logos.txt <<'EOF'
clay clay.com
anthropic wikipedia:Anthropic
linkedin commons:LinkedIn icon
acme https://acme.com/press/logo.svg
EOF
python3 KIT/.claude/skills/blue-motion/scripts/fetch-logo.py --manifest logos.txt <projet>/assets/logos
Échelle : URL explicite → Wikipedia → Wikimedia Commons → l'icône d'application du site → simple-icons → favicon. Préférez les quatre premières ; simple-icons est monochrome et la plupart des styles maison veulent de la couleur.
Sites et surfaces de produits — capturez la page réelle :
npx hyperframes capture https://<site> --json --max-screenshots 12
Les captures d'écran atterrissent localement sous forme de scènes en couches avec les actifs téléchargés. Traitez un code de sortie non nul, ok:false ou un BLOCKED.md comme un arrêt sec — n'inférez jamais le design d'une marque à partir d'une capture partielle.
Vérifiez avant de construire — toujours
- Ouvrez chaque actif qui revient. Un mauvais logo est pire que pas de logo.
- Le récupérateur émet un avertissement sous 6 Ko, et une recherche Commons peut renvoyer une quasi-erreur (mauvaise entreprise, ancienne marque, fan art). Regardez-le.
- Préférez la marque actuelle. Les entreprises changent de nom ; Wikipedia est en retard.
- Enregistrez la provenance.
fetch-logo.pyajoute automatiquement àassets/logos/SOURCES.md— gardez-le.
Gardez-le local et légal
- Copiez chaque actif dans le dossier
assets/du clip. Pas de CDN, pas de réseau au moment du rendu, jamais. - Les marques tierces sont utilisées de manière nominative — pour désigner la chose dont on parle. Ne restylez pas un logo, n'impliquez pas un aval, et n'utilisez pas une marque comme votre propre branding.
- Si aucun actif réel ne peut être trouvé ou vérifié, dites-le et utilisez plutôt le visuel de la classe d'objet. N'inventez pas une marque pour combler le trou.
Où cela s'applique dans le workflow
- Sélection des sources — pour chaque fenêtre, enregistrez quelles entités la ligne nomme. Cette liste est le manifeste de récupération. Une fenêtre nommant une entité sans actif planifié est une sélection incomplète.
- Storyboard — chaque image énonce sa thèse visuelle et les actifs réels dont elle a besoin. Si la thèse d'une image n'est exprimable que par une phrase à l'écran, repensez l'image.
- Construction — les actifs vont dans
assets/, référencés localement, vérifiés à l'œil. - Révision — plissez les yeux sur l'instantané. Si vous ne pouvez dire ce que la séquence signifie qu'en la lisant, la Loi 1 est brisée. Si une marque nommée apparaît en simple texte, la Loi 2 est brisée.
Le style maison prime toujours
Ces lois régissent ce qui va à l'écran. Comment cela se présente est dans library/design.md : sourcez l'actif réel, puis mettez-le en scène dans le style maison (sur un plateau, sous la vignette en bassin profond, à l'intérieur d'une carte en verre).