Que fait multi-video-variants ?
Transforme UN master approuvé en N livrables sans perdre le contrôle de quel fichier provient de quel état source. Ce skill possède la matrice de variantes, le gel du master, les copies de remise en page, le mix partagé, le nommage, la file d'attente (un rendu à la fois), les règles de supervision des agents et la porte de validation du manifeste. Il ne conçoit pas le master (le skill type le fait) et ne remplace pas la QA par fichier (render-qa-deliver).
Règles qui priment sur le reste de ce fichier
- Master d'abord, puis gelé. Les dérivés ne sont fabriqués qu'à partir d'un master qui a passé sa propre QA complète et qui est enregistré avec
manifest_check.py freeze. Une correction nécessaire plus tard est effectuée dans le MASTER, journalisée avecchange, reportée sur chaque copie dans le même cycle, et chaque dérivé est re-rendu et ré-enregistré. Corriger uniquement une copie est interdit. - Remise en page, jamais de recadrage. Chaque ratio est une copie de la source du master (
hf_9x16/,hf_1x1/...) avec son propre canevas, ses zones de sécurité, son échelle typographique, son rail de sous-titres, ses clés de caméra et son centrage du visage. Un recadrage ou une mise à l'échelle FFmpeg d'un master rendu n'est pas une variante. - Un seul mix. Les remises en page et les variantes de hook utilisent le même
cues.jset les mêmes octetsassets/mix.wavet sont multiplexées à partir de ce seul fichier ; l'audio n'est pas reconstruit par variante. Une variante qui a vraiment besoin de son propre mix (sans musique, propre voix off, durée recoupée) le déclare dans le manifeste avec une raison. - Un seul travail lourd à la fois sur toute la machine (rendu,
check, matte, ASR, Blender) sousrender_lock. Le travail parallèle est limité aux tâches non lourdes (mise en page, spécification, lecture QA). Au maximum 4 agents en parallèle, chacun avec au maximum 2 sous-agents. - "Prêt" est calculé, pas affirmé. Le mot n'est autorisé que lorsque
manifest_check.py checkrenvoie 0. Un délai d'attente, un dossier vide, un hash manquant,qa: not_runou une preuve manquante estbloqué/PREUVE_INSUFFISANTE, jamaisréussi. - Aucune action payante sans
paid-generation-gate; ne jamais envoyer de message à une autre session Claude ; les restrictions utilisateur et projet remplacent cette procédure. Les zones de sécurité, -14 LUFS et les canevas sont house preset v1 (décision par défaut Q5), pas une loi de plateforme.
Entrées -> sorties
Entrée : master approuvé (hf/, PROMPT.md, DESIGN.md, cues.js, assets/mix.wav) et la matrice de variantes de l'accueil. Sortie : final/<nom>_<plateforme>_<hook>_<ratio>.mp4 x N, final/manifest.json (finaux + manifeste uniquement), rapports QA par fichier sous _work/qa/<ratio>/<cycle>/, _work/agents/<agent>.progress.md, _work/STATE.md (file d'attente).
Nommage : <nom>_<plateforme>_<hook>_<ratio>.mp4, <nom> un slug ASCII en minuscules (tirets bas autorisés), <plateforme> = meta|tiktok|yt|ig|linkedin|x|all, <hook> = master | hookA | hookA-nomusic | hookA-nocaps, <ratio> = 9x16|4x5|1x1|16x9. Également acceptée : la forme courte par ratio <nom>_<ratio>.mp4 (plateforme all, hook master, comme dans le playbook de livraison). Un nom demandé par l'utilisateur dans le registre remplace la convention et est enregistré avec son identifiant de registre (record --name-ledger-id).
Procédure
| # | Étape | Faire | Artefact |
|---|---|---|---|
| 0 | Matrice à l'accueil | une ligne de registre par fichier : ratio, plateforme, route (organique / pub / spark), hook, version (complète, sans musique, sans sous-titres, durée), ratio du master. Ratios "peut-être" tardifs : écrire les notes de mise en page maintenant pour qu'une demande tardive soit un agent, pas une reconstruction (references/variant-matrix-and-layout.md) | matrice dans PROMPT.md <inputs> ; liste matrix dans le manifeste |
| 1 | Porte du master | master approuvé, QA toutes images render-qa-deliver passée, manifest_check.py freeze <projet> --hf hf --matrix ... | src_hash gelé + mix_sha256 |
| 2 | Copies de remise en page | un agent par ratio sur une COPIE ; mêmes cues et mix ; remplir le tableau de mise en page (ce qui a changé par élément, references/variant-matrix-and-layout.md) ; pré-validation 0 erreurs ; capture instantanée du overlay au hook, offre, carte de fin (--describe false, au maximum 5 timestamps par appel) | hf_<ratio>/, _work/qa/<ratio>/layout.md |
| 3 | Variantes de hook / version | hook = sous-composition liée à des variables dans la copie du ratio, une ligne par variante ; tester UNE variation d'abord (les variables par lot ne sont pas testées dans un projet) ; multiplexer le mix partagé ; sans musique / sans sous-titres = mix déclaré ou variantes de couche | rows.json, fichiers variantes |
| 4 | File d'attente | écrire l'ordre de rendu dans _work/STATE.md (master, puis chaque ratio, puis variantes) ; manifest_check.py stamp AVANT chaque rendu ; rendus via hf_deliver / render_lock run un par un ; un propriétaire de rendu ne démarre jamais un deuxième travail lourd | journal de verrouillage, timbres |
| 5 | Enregistrement | après chaque rendu : record (hashs, corrections du master appliquées, variante de mix, état QA, loudness mesuré sur le FICHIER FINAL) | manifest.json |
| 6 | QA par sortie | frame_qa, caption_qa --band <haut>:1450 (9:16), motion_qa si la mise en page a changé le mouvement, face_center audit pour les séquences du locuteur, qa delivery ; axes de revue visuelle 1 (composition/cadrage) et 4 (lisibilité) uniquement ; axes 2-3 hérités sauf si le mouvement a changé | rapports + chemins des preuves |
| 7 | Porte prêt | manifest_check.py check <projet> --json renvoie 0 ; montrer à l'utilisateur la liste des fichiers avec le hash source, l'état QA, LUFS/TP ; lister honnêtement les lacunes | RAPPORT PRÊT |
| 8 | Apprentissage | lignes de registre de timing par fichier, leçons pour la boîte de réception | _work/timing_ledger.jsonl |
Portes
Les états sont réussi | échoué | bloqué | n/a avec une raison. Un délai d'attente, un échantillon vide ou une entrée manquante est bloqué, jamais réussi. Un appel d'outil réussi est une preuve d'exécution ; un rendu visualisé est une preuve d'apparence.
| Porte | Prédicat | Preuve | Si faux | Propriétaire | Re-vérifier quand |
|---|---|---|---|---|---|
| G1 matrice | chaque sortie a une ligne de registre (ratio, plateforme, route, hook, version) avant toute construction | matrix dans PROMPT.md et le manifeste | demander l'axe manquant maintenant ; ne pas construire | ce skill + video-intake | toute nouvelle demande de ratio/variante |
| G2 master gelé | master a passé la QA complète ; freeze enregistré ; aucun dérivé démarré plus tôt | manifeste master.src_hash, frozen_utc plus ancien que chaque timbre | arrêter les dérivés ; geler | ce skill | tout changement de source du master |
| G3 remise en page | chaque dérivé a son propre canevas racine, ligne de mise en page par élément, zones de sécurité de son ratio ; pas de rendu master recadré | lignes layout.md + captures instantanées overlay + pré-validation 0 E | remettre en page l'élément défaillant ; ne pas redimensionner l'image entière | l'agent du ratio | changement de mise en page du master, nouvelle copie |
| G4 ressources partagées | cues.* et assets/mix.wav identiques au master dans chaque copie de remise en page/hook ; variantes de hook multiplexées, pas re-mixées | manifest_check.py check : pas de M035/M041 | copier les cues/mix du master en retour ; re-rendre | ce skill | changement de cue ou de mix du master |
| G5 QA par sortie | chaque fichier qa: réussi avec un fichier de preuve et LUFS -14 +/- 0,5, TP <= -1 sur le fichier final (porte maison) | chemin qa_evidence, nombres lufs, tp dans le manifeste | corriger et re-rendre UNIQUEMENT ce fichier | render-qa-deliver | tout re-rendu |
| G6 discipline travail lourd | exactement un travail lourd à la fois ; <= 4 agents, chacun <= 2 sous-agents, chacun avec liste de fichiers, fichier de sortie, date limite, fichier de progression | journal render_lock ; _work/agents/*.progress.md mtimes | mettre en file d'attente, arrêter le travail supplémentaire (arborescence de processus propre uniquement) | ce skill | chaque lancement d'agent |
| G7 manifeste prêt | obsolète / orphelin / manquant / modifié après rendu tous absents | manifest_check.py check renvoie 0 | lister les fichiers défaillants à l'utilisateur ; re-rendre les obsolètes | manifest_check.py | avant de dire "prêt", après tout changement |
Chiffres (house preset v1, daté du 2026-10-02, détails dans references/house-presets.md)
- Canevas : 9:16 1080x1920, 4:5 1080x1350, 1:1 1080x1080, 16:9 1920x1080 ; H.264 SDR yuv420p, AAC 48 kHz, 30 ips par défaut.
- Zones de sécurité, texte clé/CTA/logo/prix : 9:16 haut 300 / bas 672 (y <= 1248) / gauche 140 / droite 192, rail de sous-titres bas <= y 1450 ; 16:9 x <= 1824, haut 54, bas 162 ; 4:5 et 1:1 54 px de chaque côté. Non vérifié sur les appareils : exécuter l'exercice d'overlay.
- Loudness : -14 LUFS intégré +/- 0,5, crête réelle <= -1 dBTP, mesuré sur le fichier final ; mix intermédiaire TP <= -1,5.
- Supervision : vérification de pulsation environ toutes les 15 min ; silencieux ou en retard de plus de 20 min = vérifier, remplacer ou arrêter ; ligne de statut à l'utilisateur environ toutes les 10 min de silence ; délai de rendu 3 x l'ETA mesurée. (src : workflow distillé 02 §13.6, 2026-10-01)
Règles de décision
| Si | Alors |
|---|---|
| une correction du master est nécessaire après l'existence de dérivés | corriger le MASTER, change, reporter le patch sur chaque copie, re-rendre et ré-enregistrer tous |
| une copie a besoin d'un timing ou de cues différents | c'est un changement du master ; ou une nouvelle édition (recut) avec ses propres lignes de registre, jamais une fourche silencieuse |
| un hook a besoin d'une ligne parlée différente | déclarer own-vo avec une raison ; toute autre variante reste sur le mix partagé |
| un ratio est demandé tardivement | écrire le tableau de mise en page, générer UN agent sur une copie du master gelé ; ne pas toucher au master |
| deux rendus sont demandés en même temps | les mettre en file d'attente ; le verrou décide ; écrire l'ordre dans STATE.md |
| un agent est silencieux après sa date limite | vérifier son fichier de progression, puis le remplacer ou l'arrêter (arborescence de processus propre uniquement), puis render_lock status |
| le dossier des finaux contient un ancien rendu | le déplacer vers _work/delivered/v<N>/ ; "prêt" est bloqué jusqu'à ce que le dossier corresponde au manifeste |
| l'utilisateur nomme les fichiers | leur nom gagne ; l'enregistrer avec --name-ledger-id et garder les champs plateforme/hook/ratio explicites |
États bloqués (les signaler, ne pas les contourner)
manifest_check.py BLOQUÉ ou PREUVE INSUFFISANTE ; un dérivé avec un from_master obsolète ou une correction du master manquante ; une source modifiée après le rendu ; une dérive des cues ou du mix partagé ; qa pas réussi ; une variante promise manquante ; un fichier non planifié présent. Dire quel fichier, quel code, et la correction.
Pièges qui coûtent tous du temps réel
Demande tardive de 16:9 à la livraison (une remise en page complète, abandonnée) ; correction du master de 3,7 s non reportée au 1:1 ; un ancien rendu laissé à côté des nouveaux et personne ne l'a signalé ; un agent dérivé qui a trouvé un bug du master et n'a corrigé que sa copie ; trois agents rendant en même temps (un travail Blender parallèle a doublé un rendu, 11,5 à 21,5 min, ordinateur portable du propriétaire) ; collisions de nommage entre les coupes Meta et TikTok ; une variante de hook transportant silencieusement un mix différent. Un contact sheet visualisé de chaque ratio est encore nécessaire : les hashs ne peuvent pas voir un sous-titre sur un visage.
Références (à charger quand)
references/variant-matrix-and-layout.md- écrire la matrice, remettre en page un ratio, variantes hook/sans musique/sans sous-titres/durée.references/manifest-schema.md- enregistrer les fichiers, lire les résultats demanifest_check.py, cycle de vie des dérivés obsolètes.references/parallel-and-agents.md- lancer des agents, file d'attente, verrouillage, pulsations, arrêt, budget de jetons.references/house-presets.md- avant de citer un canevas, zone de sécurité, loudness ou numéro de plateforme (module daté).agent-content/references/platform-specs.md(faits canoniques de plateforme, détenus ailleurs) etagent-content/playbooks/wf-08-deliver.md(playbook de livraison : nommage, règles de manifeste) - préréglages d'export et le playbook ; si un nombre diffère, le fichier canonique l'emporte etreferences/house-presets.mdest mis à jour.- Autres skills :
render-qa-deliver(QA par fichier),hebrew-captions-asr(rail de sous-titres),edit-ad-promo(classement des hooks),revision-round(notes sur les ratios),paid-generation-gate. - Scripts :
scripts/manifest_check.py(--self-check29 cas, sortie 0 PRÊT / 1 BLOQUÉ / 2 PREUVE INSUFFISANTE) etscripts/test_manifest_check.py(tests unitaires).