motionable : créer
Vous arrivez avec des faits sur un produit (chacun avec une source), les réponses de l'utilisateur, des chemins d'images, des couleurs et des notes sur sa personnalité. Votre travail est un film fini qui ressemble à ce produit, et à aucun autre film du studio.
ROOT est la racine motionable : ${CLAUDE_PLUGIN_ROOT}. Si elle n'est pas développée, utilisez le dossier deux niveaux au-dessus du chemin réel de ce fichier (realpath), qui contient engine/ et scripts/.
Lisez ROOT/PLAN.md (mode planification), ROOT/ENGINE.md (les ingrédients), ROOT/rules.md (règles strictes) et ROOT/checklist.md (critique) avant de planifier. ROOT/exemples/owly/ montre à quoi ressemble un travail terminé. Ne copiez jamais son apparence, son son ou sa structure : ce n'est qu'une direction parmi une infinité.
1. Créer le film
- Où : les films vivent dans le dossier courant (généralement le studio de l'utilisateur pour les vidéos promotionnelles), sous
<slug>/.- Si le dossier courant est le dépôt du produit lui-même, utilisez plutôt
motionable/<slug>/. - N'écrivez jamais dans un dossier produit donné via
/motionable:project. - Si
<slug>/existe, demandez : créer une nouvelle version (<slug>-2/), ou continuer ce film ?
- Si le dossier courant est le dépôt du produit lui-même, utilisez plutôt
- Créez-le : exécutez
bash ROOT/scripts/new.sh <film> "<Nom du produit>". Il copie le moteur dans le film et écrit les modèles. - Ressources : copiez les images dans
<film>/assets/avec des noms clairs (logo.png,screen-accueil.png…). Un fichier de police de marque, si l'utilisateur en a un, va dansassets/fonts/.
2. Mode planification (interne : pas de commande, pas de menu de style)
Suivez PLAN.md du début à la fin :
- Tableau de preuves et personnalité.
- Histoire : promesse, moment signature, 3 accroches → 1.
- Chaque réglage défini, chacun avec sa raison.
- Unicité face au studio : lisez les
DIRECTION.mddes autres films › Empreinte. Les films créés avant la v0.2 n'en ont pas ; traitez-les comme de la house à 120 BPM en La mineur avec des titres alignés à gauche sur une carte. - Écrivez DIRECTION.md et SCRIPT.md au tempo choisi.
Ne demandez pas à l'utilisateur de choisir un style. La direction vient des preuves.
3. Une approbation
Montrez le traitement en 4 lignes (Sensation · Son · Aspect · Moment signature) et une grille de beats compacte (temps · image · mots · jonction). Puis demandez, avec AskUserQuestion si disponible (sinon dans le chat) :
- Le plan : approuvez, ou modifiez quelque chose.
- Illustrations : « Dois-je dessiner des illustrations pour ce film ? » Oui, illustrez-le / Quelques accents / Non, captures d'écran et texte seulement. Recommandez-en une avec une raison (PLAN.md §5).
- Les dessiner est gratuit : Claude écrit des SVGs.
- Uniquement si la session dispose d'un outil de génération d'images connecté, ajoutez-le comme option, et dites que cela peut coûter de l'argent.
N'écrivez aucun code de scène avant l'approbation. Une modification ici est peu coûteuse.
4. Construire
- Illustrations (si oui) : écrivez les SVGs dans
assets/drawn/dans les couleurs de la marque et une épaisseur de trait (ENGINE.md › Illustrations dessinées). Regardez chacune rendue sur une feuille, et redessinez tout ce qui est maladroit. scenes/Film.swift: remplacez complètement le squelette. Chaque valeur vient de DIRECTION.md et SCRIPT.md :- les temps vont dans
enum T; - les clips et les jonctions vont dans un
Reel; - les écrans passent par les appels de cadrage (jamais coupés dans une boîte fixe) ;
- le moment signature est redessiné pour animer exactement comme la vraie UI. Mesurez d'abord où il se trouve :
bash ROOT/scripts/inspect.sh <capture> find <sa couleur>(ourow,column,pixel) donne les anneaux, barres et bords de texte exacts. - Les éléments personnalisés dont la direction a besoin vont dans leurs propres fichiers
scenes/*.swift.
- les temps vont dans
- Son : la
Recettede la direction +Sectionsvias.compose, plus uns.cuepour chaque événement image, en utilisant les sons signature. - Vérifiez la compilation :
bash ROOT/scripts/run.sh <film> sheet(pas de temps : le film entier plus chaque jonction). Corrigez les erreurs de compilation (ENGINE.md › Pièges).
5. Brouillon, correction, puis montrer à l'utilisateur
Travaillez par brouillons, et ne bouclez jamais indéfiniment :
- Brouillon 1 est la première construction complète : scènes, musique et chaque cue. Examinez-le à partir du film lui-même (les étapes ci-dessous) ; vous n'avez pas besoin d'un fichier vidéo pour cela. (
run.sh <film> draftrend un petit MP4 rapide si l'utilisateur veut un aperçu précoce.) - Auto-examen : un seul passage, et chaque vérification.
run.sh <film> check: chaque ✗ est une correction obligatoire. Tenez la ligne plus longtemps, commencez-la plus tôt, coupez des mots, ou abandonnez la ligne. Une ligne tapée a besoin de son temps de frappe plus son temps de lecture. Tenez compte aussi de ses conseils ⚠ (image 1, rythme) sauf si DIRECTION.md explique pourquoi pas.run.sh <film> sheet: notez chaque catégorie dans checklist.md, et corrigez tout ce qui est en dessous de 8. Regardez en taille réelle lesstillsde l'accroche, du moment signature et de la carte de fin : l'UI est-elle lisible, rien n'entre-t-il en collision, chaque coin du cadre fait-il quelque chose ou est-il délibérément vide ?- Ce que les spectateurs pénalisent (RECHERCHE.md › vérification communauté) : UI trop petite à lire, rebond sur les gros éléments, plans de même longueur, musique qui sonne banque de sons, un moment logo lent.
run.sh <film> audio, puisbash ROOT/scripts/compare.sh <film>: si un autre film est trop similaire, changez la recette pour une raison.- Parcourez tout le film :
run.sh <film> sheet $(seq 0.5 1 <durée>)(une image par seconde). Cherchez ce que les stills isolés cachent : une scène qui se vide, un beat sans mouvement, une jonction qui heurte, une ligne qui apparaît juste au moment où la scène quitte.
- Brouillon 2. Corrigez tout ce qui a été trouvé en un seul lot, puis relancez
checketsheet.- Si quelque chose échoue encore, autorisez un passage de correction supplémentaire au maximum.
- Si cela échoue encore après cela, ne continuez pas : dites à l'utilisateur ce qui reste et pourquoi.
- Gardez un petit journal de critique dans SCRIPT.md : ce qui a changé et pourquoi.
- Rendez le fichier réel :
run.sh <film> video, environ 45 s pour 30 s. - Montrez-le et demandez (AskUserQuestion si disponible). Envoyez le MP4, le traitement en 4 lignes et le journal de critique, puis posez 3–4 questions ciblées sur ce montage. Chacune nécessite une option recommandée, et « Autre » laisse l'utilisateur dire n'importe quoi :
- Rythme : semble bon / plus lent, moins de lignes / plus rapide, plus d'impact.
- Son : gardez-le / plus d'énergie / plus calme / instruments différents.
- Accroche : gardez-la, ou la plus forte des deux autres candidates accroche du mode planification, nommée.
- Fin : gardez-la / une fin sécurisée pour le lancement (par exemple, pas de badge Télécharger avant que l'application soit en ligne) / ajoutez le prix.
- Révisez une fois par série de réponses, en relançant
check,audioetcompare, puis montrez le nouveau montage. Après deux séries utilisateur, proposez d'arrêter ou de continuer ; l'utilisateur décide.
6. Stocker les badges (uniquement si le produit est en ligne)
- App Store en ligne et l'utilisateur veut un badge : demandez la permission de télécharger le badge officiel d'Apple (environ 11 Ko, noir, SVG anglais ; URL dans rules.md) dans
assets/.- Dessinez-le avec
drawAppStoreBadge, fixe et jamais animé ; l'emphase vient deglowRing. - Si l'utilisateur insiste pour l'animer, expliquez la règle d'Apple une fois. S'il le veut toujours, faites-en une variante distincte et clairement nommée.
- Dessinez-le avec
- Google Play : son badge uniquement si l'application est en ligne là-bas et que l'utilisateur approuve le téléchargement. Sinon, au plus une ligne en texte brut, et seulement si c'est vrai.
7. Livrer
Avec chaque montage que vous montrez, incluez :
- le traitement en quelques lignes ;
- ce que l'auto-examen a corrigé ;
- le résultat de la comparaison et le verdict de
check; - les affirmations à vérifier avant publication ;
- comment le modifier : éditez SCRIPT.md ou DIRECTION.md, ou dites-le simplement.
Une fois l'utilisateur content, proposez les prochaines choses utiles :
- un montage de 15 s, ou un autre format (1:1, 16:9) ;
- des variantes d'accroche pour un test A/B : le même film ouvert avec les deux autres candidates accroche du mode planification ;
- une fin sécurisée pour le lancement (pas de « Télécharger » avant que l'application soit en ligne) ;
- une version effets seulement (
run.sh <film> video effects), pour publication avec un son de plateforme ou un morceau sous licence.