Film Premium
Créez des vidéos en code qui respectent les directives de la marque, n'énoncent que des faits vérifiés, et ont l'air et le son d'une production professionnelle. « Le propriétaire » ci-dessous est la personne pour qui vous réalisez le film, qui relaie souvent les retours d'un client. Les exemples proviennent de films clients réels (case-studies.md).
La barre est « premium, poli… pixel perfect ». Ce qui a échoué, selon les mots du propriétaire : « ces pilules ont l'air cheap », « un peu basique… juste suivre le script », « transition tellement bizarre », « trop rapide, je ne peux pas lire », « tombe bizarrement », « la voix est un peu jeune », « les images ont l'air tellement fausses », « un silence puis boum, c'est un peu trop ».
Les règles
- Informations correctes avant tout. Chaque fait, nom, titre, nombre, date, citation, logo et prononciation est vérifié par rapport à une source primaire avant d'être affiché à l'écran ou inclus dans la narration, et revérifié lorsque quoi que ce soit change. N'inventez et ne devinez jamais ; lorsqu'une source manque, vérifiez-la ou demandez. Les titres officiels sont copiés textuellement, les logos proviennent uniquement des propres fichiers du propriétaire, les organisations réelles obtiennent leurs vraies photos (têtes entières, pas de halos, pas de visages générés). Les démos de produits utilisent uniquement des données clairement fictives (domaines non résolus, adresses IP de documentation, noms inventés). Une seule affirmation erronée annule tout le reste du film.
- Premium dans chaque composant. La typographie, les cartes, les icônes, l'interface utilisateur, les graphiques, les transitions, la lumière, la voix, la musique et le son sont chacun conçus pour ce film à un niveau haut de gamme — rien de stock, de modèle ou de « suffisamment bon ». Construisez chaque idée comme une pièce de mouvement grande et conçue sur mesure avec des espaces négatifs ; les captures d'écran et enregistrements d'écran réels donnent une impression de « cheap », même avec une caméra qui se déplace dessus. Pas d'étiquettes de pilules, de puces numérotées, de balises en capitales suivies ou de métadonnées reliées par des points. Les images générées ne servent que de plans ou d'actifs et sont vérifiées à 100 %.
- Profondeur, lumière, caméra mobile — et pleins cadres. Les dispositions plates (texte à gauche, carte à droite, fond uni) donnent une impression de « fade ». Les moments héroïques nécessitent un décor éclairé : un sol qui reflète, des objets tournés en 3D, une lumière qui se déplace, de la poussière dans l'air, une caméra qui ne s'arrête jamais complètement. Chaque image doit fonctionner comme une affiche : des couches de profondeur, une source de lumière, le héros remplissant le cadre (texte lisible sur un téléphone), jamais un petit élément dans un vide sombre. Les points de la liste du brief sont un minimum, pas le design.
- Chaque transition est un mouvement réel. Un mouvement de caméra, une lumière ou un élément qui se déplace d'une scène à l'autre. Jamais un flash blanc plat, jamais une apparition soudaine ; les impacts reçoivent quelques images d'attaque.
- Rythme lisible et régulier. Les titres restent ≥ 2 s, les résultats ≥ 3 s après leur ligne ; les listes se révèlent un élément à la fois ; l'énergie reste constante entre les chapitres. Ne tassez jamais le contenu pour atteindre une durée.
- La narration est sacrée. Ne l'étirez jamais dans le temps et ne comprimez jamais ses pauses : coupez les mots et réenregistrez à la place. Respirez entre les lignes, un peu plus longtemps aux changements de chapitre. Chaque chapitre s'ouvre par une ligne qui relie au précédent. Une seule voix et un seul modèle par langue pour l'ensemble du film et chaque correctif ; laissez le propriétaire choisir à l'oreille.
- La musique atterrit et porte. La résolution tombe exactement sur le point culminant visuel et la musique continue sous la ligne suivante ; elle ne se vide jamais alors que l'image atteint son sommet, ne change jamais de morceau avec une coupe franche, et reste retenue à la toute fin.
- Vérifiez comme un monteur. Vous ne pouvez ni voir ni entendre le film, alors faites fonction de vos sens : des planches-contacts de chaque scène dans chaque langue, des bandes d'images à travers chaque transition, des arrêts sur image en taille réelle de chaque moment de texte, les analyses automatiques de défauts et audio, le volume par ligne, et une révision IA dont vous confirmez les affirmations sur les images avant d'agir. Un montage non vérifié de cette manière n'est pas terminé.
- Maîtrisez la boucle, rapportez simplement. Décidez de valeurs par défaut sensées et dites ce que vous avez décidé ; ne demandez que ce qui est vraiment hors de votre contrôle (une photo manquante, une clé, de l'argent). Rapportez sans noms de fichiers ou de code : ce qui a changé, ce qui a été vérifié, ce qui ne l'a pas été, où se trouvent les fichiers, lequel envoyer.
Le guide complet du goût, avec la raison de chaque règle, se trouve dans quality-bar.md. Lisez-le avant de concevoir.
Ce que vous réalisez
Choisissez d'abord le type de film ; il détermine la forme (détails et minutages dans case-studies.md) :
| Type | Typique | Narration | Images |
|---|---|---|---|
| Démo produit | 60–100 s, un montage par langue | généralement aucune ; lignes à l'écran, sous-titres optionnels | pièces de mouvement conçues sur mesure des idées clés du produit ; données fictives uniquement |
| Film de marque / organisation | 2–4 min, une langue maîtresse + autres montages | un narrateur | les vraies photos, personnes et événements de l'organisation + motion design ; chaque affirmation factuelle vérifiée |
| Ouverture d'événement / conférence | 1.5–3 min, script du client | profond et percutant | décors 3D cinématographiques, photos reconstruites en profondeur, noms et logos officiels, un point culminant qui place le titre de l'événement |
| Teaser / courte promotion | 15–45 s | une courte ligne par temps, ou aucune | une idée en trois temps : accroche, tournant (le moment héroïque), nom |
La machinerie est la même pour chaque type : Remotion (React) rend l'image en 1080p60 ; un fichier de timeline pilote l'image, la narration, la musique et les sous-titres ; Python dans Docker réalise la narration, la partition, le son et le mixage ; des mesures et une révision IA vérifient le résultat ; un script de release rend par morceaux et empaquette le livrable.
Démarrage : découvrez ce qui est disponible
Exécutez tools/setup.sh dans le nouveau projet. Il se termine par tools/providers.py, qui vérifie les clés dans .env (sans jamais les imprimer), demande à chaque service ce qu'il offre aujourd'hui, et choisit le meilleur par tâche : le dernier Gemini Flash pour réviser l'image et le son, des voix pour auditionner (ElevenLabs et Gemini TTS), et le dernier GPT Image pour les plans. OpenRouter est préféré (une clé, de nombreux modèles, un plafond de dépenses visible) ; une clé API Gemini gratuite seule couvre encore la narration et la révision ; sans clé, le film reçoit quand même une typographie conçue, une musique composée, toutes les vérifications et la release. Si une clé manquante devait augmenter la qualité, demandez à la personne une fois — le libellé, les solutions de repli et les règles d'argent sont dans providers.md. Faites confiance aux choix actuels de l'outil plutôt qu'à tout nom de modèle dans ces documents.
Workflow
Parcourez les phases dans l'ordre pour un nouveau film ; lors d'une révision, sautez à la phase que le retour touche, puis exécutez à nouveau la révision et la release. Copiez cette checklist dans vos notes et cochez-la :
Film progress:
- [ ] 0 Setup: tools available, keys checked, budget agreed
- [ ] 1 Intake: brief quoted, brand files, deliverables agreed, machine checked
- [ ] 2 Facts: fact sheet with a source and status for every claim, avoid list
- [ ] 3 Script: languages set, narration in the timeline, every on-screen word in every language
- [ ] 4 Storyboard: one idea per chapter, hand-offs planned, one look sample shown
- [ ] 5 Build: scenes from cues, stills checked in every language
- [ ] 6 Narration: voice auditioned and locked, every line cut OK, cleaned, measured
- [ ] 7 Sound: score, effects, mix (voice ≥ 6 dB over music on every line)
- [ ] 8 Review: sheets, strips, scans, AI review; every finding fixed or explained; facts re-checked
- [ ] 9 Release: outputs verified, zip tested, delivered state committed, owner told where and what to send
1. Intake
- Lisez tout ce que le propriétaire a envoyé (brief, script, rapport PDF, captures d'écran de chat, films précédents). Citez leurs mots dans
docs/brief.mdavec le journal des échanges ; notez le libellé obligatoire et les noms officiels. - Collectez la vérité de la marque à la source : fichiers de logo officiels, palette du CSS du site ou du PDF de la marque, polices qui couvrent chaque langue du film (accents, diacritiques, autres écritures), noms de produits et libellés d'interface utilisateur dans chaque langue.
- Concluez les langues et les livrables à l'avance (maîtres par langue, montages sous-titrés, .srt, vignettes, le zip) ; si le propriétaire a déjà un package d'un tour précédent, reproduisez-le exactement.
- Vérifiez la machine : espace disque libre, Docker en cours d'exécution, autres rendus ou sessions sur le même film (deux agents sur un même film ont écrasé le travail de l'autre ; si vous en trouvez un, arrêtez-vous et demandez qui le possède).
2. Recherche et faits
- Lisez les sources réelles :
tools/webpage.sh <url> <name>rend une page dans un vrai navigateur et enregistre son texte et une capture d'écran ; lorsqu'un site est indisponible, suivez la liste de repli dans story-and-research.md (une copie d'archive, d'autres sources publiques, puis le propriétaire) plutôt que de deviner. - Exécutez un sous-agent de recherche avec le brief dans story-and-research.md : chaque fait obtient des sources datées et un statut (VERIFIED / SINGLE-SOURCE / SELF-REPORTED / UNVERIFIED / OWNER-STATED), plus une liste d'évitement. Films produits : lisez le code et le libellé réels du produit pour que chaque étiquette, nombre et flux à l'écran existe dans le produit.
- Écrivez
docs/factsheet.md. Rien n'est affiché à l'écran ou inclus dans la narration à moins d'y figurer avec un statut ; les chiffres autodéclarés sont attribués.
3. Histoire et script
- Choisissez la structure pour le type de film, puis écrivez la narration comme un seul morceau parlé : des lignes de liaison à chaque changement de chapitre, des listes intégrées dans des phrases, des nombres écrits comme ils sont prononcés. Écrivez chaque langue de manière native, pas comme une traduction ; ne faites jamais dire à une voix des noms d'une langue qu'elle ne parle pas — montrez le nom, présentez la personne par son rôle.
- Placez les lignes dans
src/film/timeline.ts, les sauts de sous-titres marqués par « | » (etonScreen: truesur une ligne que le film affiche comme typographie conçue, de sorte que son sous-titre s'efface), et chaque mot à l'écran danssrc/film/script.tspour chaque langue (sa listeLANGSdéfinit les langues du film ; la première est la maîtresse).
4. Look et storyboard
- Une idée par chapitre, chacune avec son propre concept visuel, un moment héroïque, et une entrée et sortie qui passe quelque chose au voisin. Notez-le dans
docs/storyboard.md. - Décidez où la 3D réelle, les photos reconstruites en profondeur ou les plans générés sont rentables (remotion-craft.md). Montrez une image ou un clip représentatif pour tout ce qui change le look avant de construire un ensemble complet.
5. Construction
- Démarrez le projet :
<skill>/scripts/new_film.sh <dir> <Film-Name>(le nom devient les noms de fichiers livrés), puistools/setup.sh. Le starter est un film fonctionnel — timeline, horloge de scène, sous-titres, finition, kit verre et typographie, bloom, miroir au sol, poussière, lumière, photos de profondeur, trois scènes d'exemple, le moteur audio et chaque outil ci-dessous. Remplacez les scènes d'exemple ; conservez l'architecture. - Timeline d'abord : les scènes, les moments de repère nommés et les emplacements de narration vivent dans
src/film/timeline.ts; les scènes animent à partir des repères (cuesOf(scene, lang)) ;npm run cuesdonne les mêmes nombres à l'audio. Ne modifiez le timing qu'à cet endroit. - Pour un film long, répartissez les scènes entre sous-agents constructeurs parallèles avec le modèle de brief dans remotion-craft.md ; vous restez le réalisateur et vérifiez chaque rapport sur les images.
6. Narration
Méthode complète dans narration.md. Écrivez le profil du narrateur et les notes du réalisateur ; réécrivez ce que la voix comprend mal dans audio/vo/say.json ; auditionnez les voix à partir de ce que tools/providers.py a trouvé et laissez le propriétaire choisir ; enregistrez chaque lot en une seule requête (tools/vo_prompt.py → tools/tts.py), coupez et vérifiez chaque mot par ligne (tools/cut_lines.py), nettoyez-les et nivelez-les, et mesurez que les correctifs ressemblent toujours au même narrateur (tools/voice_score.py). Verrouillez la voix, le modèle et la invite exacts dans le README.
7. Musique, son, mixage
Méthode complète dans music-and-sound.md. Par défaut, composez une partition libre de droits en code qui change aux moments de repère de l'image ; coupez un morceau sous licence sur sa grille de mesure uniquement lorsque le propriétaire en fournit un. La conception sonore frappe les repères nommés. Le mixage réduit la musique par ligne, masterise à −14 LUFS avec une marge pour l'encodage AAC, et imprime un tableau voix vs musique.
8. Révision (à chaque tour, avant de montrer quoi que ce soit)
Checklist complète dans review-and-qa.md : aperçus et planches-contacts dans chaque langue, bandes à travers chaque transition, arrêts sur image en taille réelle de chaque moment de texte et sous-titre, tools/qa_scan.py sur chaque rendu, tools/audio_qa.py sur chaque mixage et fichier livré, et tools/review.py (le dernier Gemini Flash regardant et écoutant une petite copie du film entier). N'agissez que sur les drapeaux concrets que vous pouvez confirmer ; ses préférences A/B, ses jugements sur l'identité vocale et le petit texte ne sont pas fiables. Revérifiez chaque fait à l'écran par rapport à la fiche de faits.
9. Release et livraison
tools/release.sh (release-and-delivery.md) construit tout : vérification de la narration, partition et mixage par langue, sous-titres, vignettes, maîtres et montages sous-titrés rendus par morceaux, assemblés, vérifiés au pic, comptés en images, zippés. REDO= ne re-rend que les morceaux touchés ; LANGS=, VOICE= pour les sous-ensembles et versions vocales ; ZIP_ONLY=1 re-empaquette. Vérifiez les sorties, commitez l'état livré, mettez à jour le README, et dites au propriétaire exactement où se trouve le package et qu'il peut l'envoyer en toute sécurité.
10. Tours de retour
working-with-owner.md : traitez les captures d'écran de chat et les messages en cours de tâche comme le brief du tour ; vérifiez d'abord les nouvelles affirmations ; corrigez le modèle dans tout le film, pas seulement l'image montrée ; conservez ce que le propriétaire n'a pas critiqué ; relancez la révision et la release ; répondez point par point. Enregistrez chaque préférence durable là où la session suivante la trouvera.
Outils dans le projet de démarrage
Exécutez-les ; lisez leur code uniquement si l'un d'eux échoue (les premières lignes de chaque outil disent ce qu'il fait et comment l'appeler). Les outils Python s'exécutent dans des images Docker construites par tools/setup.sh (film-audio et film-asr ; setup.sh all ajoute film-voice et film-depth) : docker run --rm -v "$PWD":/p -w /p <image> python <tool> …. Les outils Node, zsh et Swift s'exécutent sur l'hôte.
| Besoin | Outil (depuis la racine du projet) | S'exécute dans |
|---|---|---|
| configurer, vérifier les clés et modèles | tools/setup.sh [all], tools/providers.py | hôte / film-audio |
| lire un site web (texte + capture d'écran) | tools/webpage.sh <url> <name>, tools/webpage.sh archive:<domain> <… |
(Le contenu a été tronqué pour la traduction ; veuillez consulter le document original pour la liste complète des outils.)
Références
Tous les fichiers de référence se trouvent dans le dossier references/. Assurez-vous de les lire avant de commencer le projet, en particulier quality-bar.md, remotion-craft.md, et review-and-qa.md.