AGHEORONO/video-dna

ADN Vidéo

Transformez un dossier de séquences en une vidéo qui donne l'impression d'avoir été montée par quelqu'un qui était sur place. Gardez l'ADN, ne réutilisez jamais un modèle : chaque vidéo obtient son propre thème, tiré de ce qui s'est réellement passé dans les séquences.

Répondez dans la langue de l'utilisateur. Les sous-titres et le texte à l'écran utilisent la langue des séquences, sauf indication contraire.

Pour commencer

1. Exécutez python scripts/doctor.py pour voir ce que cet environnement peut faire. Lisez references/environments.md si quelque chose manque, ou si vous êtes dans un sandbox cloud.
2. Regardez le dossier de travail, puis lisez references/brief.md et recueillez le brief. Ne demandez que ce que la demande et le matériel ne répondent pas déjà.
3. Lisez references/formats.md et utilisez la recette la plus proche de la demande. S'il n'y a pas de matériel, suivez « Pas de matériel » dans references/brief.md.
4. Lisez references/pipeline.md avant de construire la timeline, et references/tools.md lorsqu'un travail nécessite plus que les scripts de base.

Flux de travail

Faites-les dans l'ordre. Ne rendez rien avant l'étape 5.

0. Brief. Déterminez le format, l'orientation, la durée, le rythme, l'intensité du mouvement, l'identité visuelle et l'audio. Voir references/brief.md. Utilisez ses choix pour toute la vidéo.
1. Inventaire. Listez les clips, photos, musiques et logos, s'il y en a. Créez des planches contact avec scripts/contact_sheet.py et examinez-les. Transcrivez la parole avec scripts/transcribe.py, en commençant par les clips les plus courts et les plus denses. Les répliques réelles sont généralement le matériel le plus amusant.
2. Histoire. Notez ce qui s'est réellement passé, dans l'ordre, avec les meilleures répliques réelles et qui les a dites. Demandez qui sont les personnes si on ne vous l'a pas dit.
3. Thème. Proposez 2 à 3 nouveaux thèmes, chacun avec 2 gags concrets tirés de moments réels. Recommandez-en un, en privilégiant un thème que les séquences suggèrent déjà. Puis arrêtez-vous et laissez l'utilisateur choisir. Voir references/themes.md.
4. Musique. Proposez une piste par section avec un nom de fichier cible, et demandez à l'utilisateur de placer les fichiers dans le dossier. Un nom tel que 2_chorus_0m45s.mp3 signifie « démarrer à 0:45 ». Ne téléchargez jamais de musique commerciale, même si on vous le demande. Proposez plutôt des sons générés et une version sans musique.
5. Échantillon d'abord. Pour tout ce qui dépasse environ 45 secondes, rendez un court chapitre pour que l'utilisateur puisse juger de la direction. Construisez ensuite le reste.
6. Vérification. Exécutez scripts/qa.py, examinez les images extraites et parcourez references/qa-checklist.md. Corrigez ce que vous trouvez avant de livrer.
7. Livraison. Voir « Où va la vidéo terminée » ci-dessous. Incluez une version sans musique lorsque c'est utile, du texte prêt à coller depuis references/copy.md, et le rapport honnête.

Où va la vidéo terminée

scripts/doctor.py rapporte l'environnement. Terminez chaque vidéo de cette façon :

• Claude Code : écrivez les vidéos terminées directement dans le dossier de l'utilisateur, dans output/ à l'intérieur du dossier de travail, sauf s'il nomme un autre endroit. Donnez les chemins complets. L'utilisateur ne devrait jamais avoir à chercher dans _work/.
• Application Claude : livrez les vidéos terminées directement dans le chat, comme des fichiers que l'utilisateur peut ouvrir et télécharger depuis la conversation. Copiez-les dans le dossier de sortie (/mnt/user-data/outputs lorsqu'il existe) et utilisez l'outil de partage de fichiers si disponible. Ne vous arrêtez pas à un chemin sandbox, et ne réduisez pas ou ne fractionnez pas un fichier, sauf s'il ne parvient pas à être livré.

L'ADN

• Un thème, pleinement adopté. Mêmes polices, couleurs, animations et son de la première à la dernière image. Chaque graphique appartient au monde du thème.
• Chaque graphique porte une vraie blague ou un vrai fait issu de ces séquences. Rien de décoratif, rien de générique. Une étiquette indiquant une valeur réelle sur un écran réel surpasse toute légende générique.
• Rappels. Plantez quelque chose tôt et payez-le tard. Une réplique du début revient à la fin.
• Accrochez dans les 2-3 premières secondes avec le moment le plus fort, puis revenez au début d'une manière qui appartient au thème.
• Rythme. Coupez sur le beat, zoom punch sur les punchlines, utilisez des transitions animées, secouez sur les impacts, accélérez les passages ennuyeux. Laissez les répliques parlées entières.
• Sous-titres pour toute parole, mot par mot, stylisés selon le thème. Censurez les gros mots à l'écran uniquement.
• Conception sonore. Chaque graphique a son propre son. La musique change par section, le gros hit de la piste tombe sur le moment clé, et la musique baisse sous la parole.
• La clarté prime sur la densité. Si une blague nécessite un contexte que le spectateur ignore, coupez-la. Pour un spectateur novice, quoi, où, quand et combien doivent être clairs.

Règles de vérité

• N'inventez jamais un fait. Tout ce qui est déduit, approximatif ou illustratif doit être listé pour confirmation : dates, rôles, chiffres, prix, tailles, qui a dit quoi.
• Listez les lignes de transcription incertaines pour que l'utilisateur les confirme. transcribe.py signale les mots de faible confiance.
• Les chiffres illustratifs qui pourraient être interprétés comme des résultats réels doivent être signalés ou supprimés.
• Ne mettez pas de mots dans la bouche de vraies personnes en tant que citations. Les blagues écrites sont acceptables lorsqu'elles se lisent comme des légendes.
• Demandez avant d'inclure des moments embarrassants de personnes, et avant de montrer des visages d'inconnus sans floutage.
• Gardez le texte officiel des sponsors et bailleurs de fonds mot pour mot. S'il ne correspond pas à leurs logos, demandez plutôt que de le modifier.
• Vérifiez la destination d'un code QR et prévenez l'utilisateur s'il s'agit d'un document ouvertement modifiable.

Gestion des corrections

Appliquez les retours exactement et ne touchez à rien d'autre. Conservez la timeline en tant que données, de sorte qu'un changement ne re-rend que les segments affectés. Lorsque quelque chose doit être retiré pour rester dans une limite de durée, dites ce que vous avez retiré.

Rapport honnête

Vous ne pouvez pas entendre l'audio ni regarder en temps réel. Énoncez-le chaque fois, en termes clairs :

• ce que vous avez vérifié (images extraites, durées, niveaux, décodage QR) ;
• ce que l'utilisateur doit juger à l'oreille et à l'œil (synchronisation sur le beat, timing des sous-titres, équilibre du mix) ;
• ce que vous avez retiré, et ce que vous n'avez pas pu faire comme demandé ;
• si les plateformes peuvent couper le son de la vidéo à cause de musique commerciale.

Fichiers inclus

Fichier	Utilisation
scripts/doctor.py	Vérifier les outils et dépendances
scripts/contact_sheet.py	Grilles d'images horodatées pour examiner les séquences et les rendus
scripts/transcribe.py	Transcription mot par mot avec indicateurs de faible confiance
scripts/captions.py	Sous-titres ASS mot par mot, cartographiés sur la timeline
scripts/beats.py	Tempo, temps forts et hits les plus puissants d'une piste
scripts/sfx.py	Générer des effets sonores libres de droits
scripts/music.py	Générer un simple chiptune original ou un fond musical pulsé qui boucle
scripts/setup_tools.py	Vérifier et installer des outils optionnels par profil, et sauvegarder les modèles Whisper
scripts/toolbox.py	Détection de scène, cutouts, visages, QR, polices, scènes HTML, stems, voix off, loudness, export de timeline
scripts/render.py	Timeline JSON vers MP4 final, avec une version optionnelle sans musique
scripts/qa.py	Vérifications de durée, format, taille, loudness, ASS et QR
scripts/fit_size.py	Compresser à une taille cible, ou fractionner pour transfert
references/brief.md	Questions à poser au début, et que faire avec un dossier vide
references/formats.md	Recettes par type de vidéo
references/themes.md	Comment trouver un thème, avec des exemples travaillés
references/pipeline.md	Format de timeline, règles de rendu, recettes d'animation ASS
references/tools.md	Quel outil pour quel besoin, y compris les backends Whisper
references/environments.md	Différences entre Claude Code et l'application Claude
references/qa-checklist.md	Vérifications avant livraison
references/copy.md	Légendes de publication et messages partageables