video-director-previs
Prenez des décisions créatives coûteuses à l'étape la moins chère. Cette compétence gère la pré-production : direction, histoire, scénario, storyboard, styleframes, animatique, musique, effets sonores, voix, choix du moteur, assurance qualité, révision, versions et approbation. Les moteurs (HyperFrames, video-shotcraft, Remotion, motion-reel, bang-motion, Diffusion Studio) ne construisent que ce que le propriétaire a approuvé.
Exemple concret : examples/crumb-previs/ (une application de partage de facture fictive). Son pack de données est le film de démonstration dans Previs Studio (_shared/previs/studio/films/011-crumb/).
L'application ne change jamais par film. Previs Studio est une application React + TypeScript fixe (source _shared/previs/app/, voir son README). npm run build y effectue la vérification de type, regroupe et intègre le tout dans _shared/previs/studio/index.html et _shared/previs/page/index.html (template) ; ajoutez une cible dans scripts/inline.mjs pour chaque page par film. npm run smoke pilote la page construite dans un vrai Chrome en mode desktop, tablette, téléphone et plein écran (captures d'écran avec --out). Ne modifiez jamais manuellement le index.html construit.
Ce que le propriétaire obtient : Regarder (lecteur vidéo avec vrai plein écran, prévisualisation au survol, carte de fin ; mode commentaire qui nomme la plus petite partie sous le pointeur, défilement pour agrandir ou réduire, glisser une boîte autour de plusieurs parties, stylo et flèche, glisser sur la rangée de plans pour une plage temporelle ; pistes sonores avec formes d'onde, battements, courbe de duck, solo/mute/volume et effets sonores glissables qui s'accrochent au rythme), choix qui rejouent leur moment en place avec le son, comparaison côte à côte, maintenir pour entendre l'original, Storyboard (cartes qui jouent leur plan en place, Lire tout, choix par plan, une feuille de plans), Plan (directeur en chef, histoire, équipe de réalisation, aspect visuel, son, assets, production, vérifications, versions avec « demander à annuler », exportation du cahier des charges), une révision guidée, Demander au réalisateur, recherche ⌘K, annuler/rétablir, thèmes clair et sombre, infobulles sur chaque contrôle. Les films arrivent uniquement sous forme de packs de données.
Deux foyers, même application
- Previs Studio (tous les films) :
_shared/previs/studio/. Ajouter un film = ajouterfilms/<id>/previs.json+films/<id>/audio/...et une ligne dansfilms.json. Localement :python3 -m http.server --directory _shared/previs/studio(ou l'entréeprevis-studiodans.claude/launch.json). - Page par film :
projects/NNN/previs/page/contient une copie du mêmeindex.html(titre<Produit> Previs),films.jsonavec une ligne dont lepathest"",previs.jsonetaudio/. - En tant qu'Artifact claude.ai (Claude uniquement) : publiez la page avec les
capabilities: {"db": {}, "user": {}, "sample": {}, "comments": {}, "downloads": true}.dbstocke les notes et les choix,samplealimente Demander au réalisateur,commentstransporte « Envoyer à Claude Code »,downloadsl'exportation du cahier des charges. Sans elles, la page fonctionne toujours et sauvegarde dans le navigateur. - Chemins de base de données : commentaires (demandes de modification épinglées au film ; la collection conserve l'ancien nom)
films/<id>/notes(kindframe, region, range, sound, shot, revert ou request ;target,targets,box,strokes,quick,t/t2,picksetversionau moment donné) ; choix et ajustements sonoresfilms/<id>/state/picks(tweaks:<scene>.<sfx>{dt, db},lane.vo|music|sfx{db},mix.duck{on}) ; options ajoutéesfilms/<id>/state/custom; approbationfilms/<id>/state/approval; statut de Claudefilms/<id>/state/claude; activitéfilms/<id>/activity; notes (pensées libres sur l'ensemble du film : lisez-les comme contexte, jamais comme des tâches)films/<id>/pad.
Bibliothèques : plus de trois options à la demande
Chaque décision est livrée avec trois options de réalisateur ; D['libraries'] en ajoute d'autres que le réviseur (ou l'onglet Demander) peut importer : direction (aspects visuels : ensembles de tokens + fonts_url), music (pistes CC0 avec bpm, phase, tags, level), motion (ease, spring {f,d} ou bezier), pacing, camera, transition, sfx (chaque son du film) et voice (voix Fish : dir, durs, texts pour d'autres langues, intro, sample). La décision voice globale choisit le narrateur ; une voix résout chaque ligne en <dir><scene>-<A|B|C>.mp3, et une voix avec needs et sans dir est lue sous forme de sous-titres jusqu'à ce qu'elle soit enregistrée. Les options ajoutées vivent dans la base de données de la page, sont annulables et vont dans le cahier des charges approuvé. Construisez les bibliothèques avec examples/crumb-previs/libraries.py comme modèle :
- Musique : recherchez Freesound CC0 (
freesound.py search ... --min-dur 20),freesound.py get, puispython3 _shared/previs/music_lib.py <page>/audio/music/lib <oggs>(extraits de 24 s alignés sur le rythme, BPM mesuré) ; écrivez les tags et un pourquoi par piste ; lignes dans_shared/ASSETS.md. - Voix : choisissez des voix Fish publiques avec
search_voices(pas de clones de personnes réelles ou de personnages), listez-les dansvoices/voices.tsv, écrivezvoices/lines-<lang>.txt, exécutezvoices/make_voices.sh(modèle gratuit), puis vérifiez les prises avec whisper-cli et régénérez celles qui perdent des mots. - Le réalisateur IA (onglet Demander,
lib/director.ts) peut également concevoir des looks (contraste vérifié, polices Google autorisées), des sensations de mouvement et de nouvelles formulations de lignes (celles-ci nécessitent un enregistrement : il dépose une note de demande pour Claude Code).
Le côté de Claude Code dans les notes (faites ceci à chaque tour)
Le propriétaire envoie des notes depuis la page (« Envoyer à Claude Code » : un commentaire en direct qui réveille une session en observation, ou un message copié). Ensuite :
0. Tirez avant de modifier. Claude sur claude.ai peut répondre à un fil « Envoyer à Claude Code » par lui-même, modifier le fichier de données et publier une nouvelle version. Avant de construire, lisez le previs.json publié, comparez-le avec votre construction locale et reportez toute modification dans build_previs.py afin que la prochaine construction la conserve.
- Définissez
films/<id>/state/claude {state:"reading"|"working"|"publishing"|"idle", at, message, version, open}pour que la page montre ce que vous faites. - Pour chaque note ouverte : mettez-la à jour avec
claude: {state:"seen"}une fois lue,{state:"working"}pendant la modification, puisstatus:"done",claude:{state:"done", at, msg}et ajoutez{by:"claude", text, at}àreplies(épinglezif_version). Utilisezstate:"question"(avec la question dansmsg) lorsque vous avez besoin du propriétaire,"wontfix"lorsque vous recommandez de conserver. Les notes aveckind:"request"sont des tâches de l'onglet Demander (enregistrer une nouvelle ligne, trouver un son) ;preferpointe vers l'option que le propriétaire aime ;intent:"question"veut une réponse, pas une modification. Chaqueatest l'heure réelle : prenez-la dedate -u +%Y-%m-%dT%H:%M:%SZ, jamais une estimation. - Ajoutez des lignes à
films/<id>/activity({at, by:"claude", kind:"seen"|"applied"|"published"|"question", text, version}) : ce que vous avez lu, ce que vous avez modifié, ce que vous avez publié. - Répondez dans le fil de commentaires de la page si le propriétaire a utilisé Envoyer à Claude Code, puis résolvez-le.
Règles
- Un seul réalisateur, pas de comité. Travaillez vous-même à travers la liste de contrôle spécialisée ci-dessous, dans l'ordre. Pas de workflows ou de sous-agents sauf si le propriétaire le demande (règle de coût).
- Inférez agressivement ; ne demandez que les vrais bloqueurs (vérité produit, un asset manquant, une question de licence). Jamais un long questionnaire avant que le propriétaire voie quelque chose.
- Trois options pour chaque décision, par défaut. Direction, musique, sensation de mouvement, rythme, et par scène : transition, caméra, ligne de voix, chaque événement SFX. Les options doivent être réellement différentes. Marquez le choix du réalisateur et donnez à chaque option une phrase simple de raison ou de compromis. « Rien » est une option SFX valide.
- Vérité produit. Chaque scène est étiquetée
real_ui,conceptual_ui,conceptual_visualouexternal_footage; tout ce qui n'est pas réel affiche une étiquette dans le lecteur. - Les règles de la maison s'appliquent toujours (AGENTS.md, OWNER.md) : clichés interdits, mentions légales, deux niveaux de texte, bruitages enregistrés, voix par défaut, licences. La page ne joue que de l'audio CC0 ou auto-produit ; Mixkit (rendu uniquement) apparaît uniquement par son nom.
- Réduisez l'échelle. Un extrait de 6 s peut être une carte de direction, 3 options musicales et une animatique de 6 s. Un film produit de 40 s reçoit l'ensemble complet.
- Verrous. Une fois que le propriétaire approuve, l'histoire, le texte, l'ordre, le timing et les choix sont verrouillés. Une note ultérieure ne modifie que sa cible ; listez ce que vous avez préservé.
Liste de contrôle spécialisée (le réalisateur couvre chaque point, brièvement)
Histoire (accroche avant 2 s, un état par temps fort) · scénario et lignes de voix (mots par seconde ≤ 3.4) · rythme éditorial (varier la durée des plans, pauses, pas toutes les coupes sur le rythme) · direction artistique (3 directions sous forme d'ensembles de tokens : bg, on-bg, card, on-card, muted, line, paper, on-paper, accent, on-accent, frame, display, ui, mono) · typographie · références (emprunter / éviter / où utilisé ; grammaire, jamais contenu) · caméra (chaque mouvement a une raison) · mouvement (but, easing, dépassement ≤ 4% sur l'UI, aucun sur le texte) · transitions (un simple cut est valide) · assets (existants / nouveaux / générés / placeholders, avec licence) · musique (BPM et phase mesurés, courbe d'énergie, où le drop tombe) · SFX (asset, temps, déclencheur, gain, pourquoi) · mix (voix en avant, duck de 8 dB, impact le plus fort) · moteur (choisi, pourquoi, alternative, repli) · QA.
Fichiers (un dossier par film)
projets/NNN-nom/previs/
build_previs.py # écrit page/previs.json ; copiez examples/crumb-previs/build_previs.py et modifiez (scènes = styleframe HTML + animations tweens)
vo-lignes.txt # 3 formulations par ligne, pour fish_tts.py
page/index.html # construit par _shared/previs/app (npm run build ; ajoutez cette page comme cible dans scripts/inline.mjs)
page/films.json # [{"id": "NNN-nom", "name": "Produit", "path": ""}]
page/previs.json # l'ensemble du plan
page/audio/{musique,vo,sfx}/
changements.jsonl # journal des modifications append-only, une opération par ligne
approved-video-spec.json # écrit par _shared/previs/freeze_spec.py après approbation
Étapes
- Lisez le brief ou la demande en une ligne et la source du produit (UI réelle, tokens, texte). Écrivez
BRIEF.mdavec les décisions inférées. - Audio (pas cher, local) :
- Pistes de fond : mesurez le tempo et la phase par combinaison sur 85–150 BPM sur une enveloppe de débuts basse fréquence (
AGENTS-tooling.md, « Previs ») ; coupez des extraits de 24 s commençant sur un temps, normalisez à −18 LUFS :ffmpeg -ss <phase> -t 24 -i piste.wav -af "loudnorm=I=-18:TP=-2,afade=t=out:st=22.5:d=1.5" page/audio/musique/A.mp3. - Voix :
python3 _shared/tools/fish_tts.py --lines previs/vo-lignes.txt --out-dir previs/vo-wav(modèle gratuit), puis supprimez le silence danspage/audio/vo/sN-{A,B,C}.mp3. - Bruitages : copiez les aperçus CC0 depuis
_guide/prompt-studio/media/foley/ou récupérez-les avecfreesound.py.
- Pistes de fond : mesurez le tempo et la phase par combinaison sur 85–150 BPM sur une enveloppe de débuts basse fréquence (
- Planifiez dans
build_previs.py(voir l'exemple pour chaque champ) :project,summary,chief,story(temps forts → scènes),directors,assets,gates,pipeline,changes,directions(3),global.music|motion|pacing|voice(3 chacun),engine,references,style_rules,audio_notes,qa,versions,film_css(toutes les couleurs via des tokens, classes préfixéesf-),fonts_url, etscenes[]avechtml,anim(tweens{s, t:[a,b], f, to, e}sur x, y, s, sx, sy, r, o, clip, w, blur ;{s, set, at, until}bascules de classe ;{s, count:[from,to], t, p, d}compteurs ;e:'m'suit le choix Motion),decisions(types de transition cut, push, slide, zoom, iris ; caméra{s,x,y,origin}; vo{text, src, dur, at, copy}),sfx(atpeut être une liste pour des séquences),key(le moment de l'image fixe du storyboard). Donnez à chaque élément que le propriétaire pourrait pointer un simpledata-name(« Total reçu », « Bouton de demande »). - Vérifiez localement : servez le dossier de la page, regardez une image fixe de chaque scène et une mi-transition, basculez les trois directions une fois, confirmez qu'il n'y a pas d'erreurs dans la console. Un passage, pas de boucle.
- Partagez la page (localement, ou en tant qu'Artifact claude.ai avec les capacités ci-dessus) et ajoutez le film à Previs Studio. Donnez au propriétaire le lien et un résumé de cinq lignes. Arrêtez-vous pour révision.
- Boucle de révision (chaque tour est une republication) :
- Lisez les notes, les choix et l'approbation.
- Pour chaque note ouverte : ne modifiez que sa cible, ajoutez une opération à
changements.jsonl({"v","cible","t","modification","de","vers","raison","préserver":[...]}), puis marquez la note comme terminée avec une réponse d'une ligne (protocole ci-dessus). Une noterevertdemande d'annuler une modification listée. - Incrémentez
versionset ajoutez leschangesdu tour dansbuild_previs.py, réexécutez-le, copiezprevis.jsondans la copie de Studio, republiez. Le lecteur affiche une bannière « ce qui a changé » et le Plan liste chaque modification avec une demande d'annulation.
- Approbation : lorsque
state/approvalaapproved: true(il contientpicks,tweaksetcustom), sauvegardez-le, exécutezpython3 _shared/previs/freeze_spec.py projects/NNN-nom/previs --approval <fichier>(il résout les options ajoutées et la voix, et listeneeds_before_buildcomme les lignes non enregistrées), écrivezSHOTLIST.mdà partir du cahier des charges, puis passez à la compétence moteur nommée dans le cahier des charges. Le moteur construit exactement le cahier des charges (polissage autorisé, décisions non).
Coût
Travail en solo uniquement. Une prévisualisation de 20 s représente quelques heures d'une seule session (environ 30 à 60 $ équivalent API), avec Fish sur le modèle gratuit et aucun rendu. Le rendu de production et ses vérifications viennent après approbation.