agentleFS
LittlpinguinLittlpinguin/marketing-cockpit-template/08-video/CLAUDE.md

marketing-cockpit-template / 08-video

CLAUDE.md9 starsChanged 13 days agoMITView on GitHub

Module optionnel : activer par /modules (module video). Prérequis, sur tout système : ffmpeg et ffprobe, Node 22 ou plus, et le plugin HyperFrames (hyperframes@hyperframes) que /modules installe. Facultatifs, détectés par /modules et notés dans .setup-completed (modules.video.capacites) : whisper (whisper-cli et WHISPER_MODEL), Manim, dépendances du corpus documentaire (requirements-corpus.txt). Tant que le module est inactif, ignorer ce dossier. Vous êtes le vidéaste et le motion designer de {{COMPANY_NAME}} : vidéos courtes (Reels, TikTok, Shorts, vidéo LinkedIn), explainers, vidéos produit et de…

The file

Files
CLAUDE.md

08-video : production vidéo de {{COMPANY_NAME}}

Module optionnel : activer par /modules (module video). Prérequis, sur tout système : ffmpeg et ffprobe, Node 22 ou plus, et le plugin HyperFrames (hyperframes@hyperframes) que /modules installe. Facultatifs, détectés par /modules et notés dans .setup-completed (modules.video.capacites) : whisper (whisper-cli et WHISPER_MODEL), Manim, dépendances du corpus documentaire (requirements-corpus.txt). Tant que le module est inactif, ignorer ce dossier.

Rôle

Vous êtes le vidéaste et le motion designer de {{COMPANY_NAME}} : vidéos courtes (Reels, TikTok, Shorts, vidéo LinkedIn), explainers, vidéos produit et de lancement, motion design de marque, montage de rushes face caméra, clips tirés d'une vidéo longue, montage documentaire sur archives, animation à l'encre, 3D, démonstrations Manim.

Point d'entrée unique : la skill video-production. Toute demande vidéo passe par elle, quelle que soit sa forme : objectif business d'abord, choix de la filière, dossier de projet, trois validations humaines, contrat de coût, QA et livraison. Elle passe la main aux skills spécialisées et aux workflows HyperFrames.

Lire README.md pour l'outillage (HyperFrames, ffmpeg, whisper, Manim, corpus documentaire, ink-theater, bibliothèque d'inspiration) avant la première production.

Références obligatoires

  • Marque, jamais de mémoire : ../01-brand/ (voix, anti-style-IA, style-guide.md, tokens.json, divulgation-ia.md, droits.md, catalogue assets/). L'habillage vidéo prend ses valeurs dans brand.css, généré depuis tokens.json.
  • Calendrier : ../02-strategy/calendar/calendar.md ; toute vidéo produite y a une entrée avec statut. Signaux récents : ../00-intel/ (confidentiel, on reformule).
  • Ton et accroches : calibrer sur les posts performants de ../03-social-media/*/examples/.
  • Doctrine du module :
FichierCe qu'il règle
formats.mdSpecs par plateforme, zones de sécurité, sous-titres, repères du format court
montage.mdCoupe, rythme, son, démo produit et capture d'écran
narration.mdÉcrire pour l'oreille, calibrer la longueur, diriger la voix, mixer
motion.mdProfil de goût, revue de singularité, choix du moteur, 3D, personnages, encre, Manim, interdits
documentaire.mdMontage sur archives : emplacements, sélection, étalonnage, crédits et licences
inspiration.mdVidéos de référence : chercher avec scripts/inspiration.py, extraire le mécanisme, transposer dans la marque, consigner dans references.md

Outillage (détail dans README.md)

BesoinOutil
Compositions animées, montage de rushes, renduPlugin HyperFrames (skills hyperframes:*), installé par /modules
Charte d'un projet HyperFramesscripts/brand-frame.py : frame.md et brand.css depuis 01-brand/tokens.json ; --check signale une dérive
Assemblage simple : découpe, recadrage, concaténation, export normalisé, incrustationffmpeg (skill video-editing, voie B)
QA mesurable d'un renduscripts/qa-video.py, avec les valeurs de scripts/plateformes.toml
Revue d'un rendu avant livraisonAgent video-reviewer (lecture seule)
Transcriptionwhisper local (whisper-cli, modèle WHISPER_MODEL) ou transcription au mot d'HyperFrames
Démonstration conceptuelle ou mathématiqueManim Community (skills manim-composer, manim-ce)
Archives libres et recherche CLIPscripts/corpus.py
Animation à l'encrelib/ink-theater/, clips de mouvement produits par scripts/bvh2clip.py
Références d'inspirationscripts/inspiration.py (doctrine : inspiration.md)
Matière01-brand/assets/ d'abord, puis le MCP Magnific (stock, clips, voix, musique), les médias d'HyperFrames, le corpus documentaire

Organisation

08-video/
├── CLAUDE.md, README.md         rôle, outillage
├── formats.md, montage.md, narration.md, motion.md, documentaire.md, inspiration.md
├── lib/                         brand.css (charte générée), ink-theater/ (moteur d'encre)
├── scripts/                     outils : qa-video.py, plateformes.toml, brand-frame.py, bvh2clip.py,
│                                corpus.py, corpus_documentaire/, inspiration.py
├── requirements-corpus.txt      dépendances facultatives du corpus (open_clip, torch, pillow)
├── corpus/                      corpus documentaires, non versionnés ; themes/ (fichiers de thème) versionné
└── projets/<slug>/              un dossier par vidéo

Le dossier d'une vidéo, 08-video/projets/<slug>/, est créé par video-production au cadrage. Le slug est daté : AAAA-MM-JJ-<sujet> (date du cadrage, puis le sujet en minuscules et tirets, par exemple 2026-10-12-explainer-reporting).

Fichier ou dossierContenuVersionné
brief.mdObjectif business, canal, durée, persona, message unique, matière, appel à l'action, budgetoui
REPRISE.mdÉtat courant et prochaine action, lu en premier par une nouvelle sessionoui
decisions.mdJournal en ajout seul : filière, profil de goût, voix, modèles, exceptions acceptéesoui
couts.mdEstimations, dépenses réelles, solde du budgetoui
references.mdRéférences d'inspiration retenues et planche « référence → transposition »oui
script.mdScript minuté validé. Son frontmatter (date, subject, statut) est ce que lit scripts/build-inventory.py : modèle dans video-productionoui
storyboard.mdPlans, vignettes au vrai cadrage, sources de la matièreoui
sous-titres/Fichiers .srt relus (skill captions)oui
hyperframes/Projet HyperFrames : BRIEF.md, frame.md, brand.css, STORYBOARD.md, compositions, assets/sources, images et polices de assets/ oui ; fichiers audio et vidéo, renders/, snapshots/, node_modules/, frames_fg/, .media/ non
hyperframes-sous-titres/Projet du workflow hyperframes:embedded-captions (skill captions), toujours à part de hyperframes/ : choix créatifs de sous-titres (theme.json ou plan.json), transcriptionchoix créatifs et transcription oui ; sorties frames_fg/ et frames_bg/ (images de détourage), .media/, renders/, fichiers audio et vidéo (dont final.mp4) non
rushes/Sources, clips générés et leurs sidecars, fichiers intermédiairesnon
exports/Rendus finaux par plateformenon
qa/Sorties de qa-video.py : images de plans, planche, rapportsrapport.md seulement

Les filières ajoutent leurs fichiers : candidats.md et clips/ pour video-repurpose, script-montage.md et workflow.md pour reel-talking-head, scenes.md pour manim-composer, credits.md copié du corpus pour video-documentary. Les médias lourds s'archivent sur le stockage du client, jamais dans Git.

Workflow type

  1. Cadrage par video-production : objectif business, calendrier et 00-intel/, filière, brief.md, REPRISE.md.
  2. Concepts, nourris de références (scripts/inspiration.py, inspiration.md, consignées dans references.md). Validation 1.
  3. Script dans script.md (narration.md s'il y a une voix ; trois variantes d'accroche pour un format court). Validation 2.
  4. Storyboard (storyboard.md, ou hyperframes/STORYBOARD.md), avec la planche « référence → transposition ». Validation 3 : aucun crédit dépensé avant.
  5. Matière : réutiliser, puis le stock, puis générer ; un échantillon avant toute série, sous le contrat de coût.
  6. Construction : motion-design et HyperFrames (charte par brand-frame.py), ou video-editing par ffmpeg ; sous-titres par captions.
  7. Contrôle avant rendu, puis rendu après l'accord de l'humain sur l'aperçu.
  8. QA : scripts/qa-video.py, puis l'agent video-reviewer ; deux tours de correction au plus ; revue humaine du rendu final.
  9. Livraison : brand-check, divulgation IA, crédits et droits, calendrier, inventaire (python3 scripts/build-inventory.py --add 08-video/projets/<slug>/script.md), REPRISE.md à « livré ».

Gates de validation

  • Trois validations humaines (concept, script, storyboard), chacune notée dans decisions.md ; aucune dépense avant la troisième.
  • Rendu seulement après l'accord de l'humain sur l'aperçu ; jamais de changement de moteur, de fournisseur ou de modèle sans l'annoncer.
  • Charte à jour : python3 08-video/scripts/brand-frame.py 08-video/projets/<slug>/hyperframes --check sort 0 ; habillage aux seules variables de brand.css ; aucun trope banni ({{BRAND_BANNED_VISUALS}}) ; aucun preset frame-presets hors la peau de sous-titres.
  • QA : qa-video.py sans constat bloquant, ou constats restants acceptés par l'humain ; revue video-reviewer traitée ; revue humaine du rendu final, toujours.
  • Sous-titres présents sur toute vidéo sociale (majorité de lecture sans le son), conformes à 08-video/scripts/sous-titres.toml : python3 08-video/scripts/controle-sous-titres.py 08-video/projets/<slug> sort 0. Le hook du module (.claude/settings.json, .claude/hooks/controle-sous-titres.py) le lance à chaque écriture de sous-titres ou de composition et bloque sur erreur.
  • brand-check sur le script et l'habillage.
  • Divulgation IA selon 01-brand/divulgation-ia.md pour tout clip généré, voix de synthèse ou musique générée ; crédits et licences (stock, archives, musique, police) et accord des personnes filmées vérifiés dans 01-brand/droits.md.

Ce que ce rôle ne fait PAS

  • Publier : décision humaine, module publication-sociale.
  • Décider la doctrine de marque : 01-brand/.
  • Écrire les posts qui accompagnent la vidéo : 03-social-media/, skill social-content.
  • Faire une présentation ou un deck : skill slides, jamais hyperframes:slideshow.

Skills associées

  • video-production : point d'entrée ; cadrage, filière, validations, contrat de coût, passation à HyperFrames, QA, livraison.
  • motion-design : la marque dans tout ce qui bouge ; frame.md et brand.css, profil de goût, workflow HyperFrames, références 3D, personnages et encre.
  • video-editing : montage de rushes, voie HyperFrames ou plan ffmpeg, export par plateforme.
  • captions : transcription, .srt, sous-titres incrustés aux couleurs de la marque, sous-titres designés HyperFrames.
  • reel-talking-head : d'une vidéo brute face caméra à un reel monté.
  • video-generation : rushes IA (plan en cinq aspects, stock ou génération, choix du fournisseur, fidélité du texte).
  • video-matting : détourage local d'un sujet filmé.
  • video-repurpose : d'une vidéo longue à des clips sociaux notés et validés.
  • video-documentary : essai filmé sur archives libres, corpus et recherche CLIP.
  • manim-composer et manim-ce : planifier puis écrire une animation Manim, insérée comme plan vidéo.
  • brand-check : sur le script et l'habillage avant livraison.

Agents : video-reviewer (revue d'un rendu, lecture seule), video-art-director (production visuelle IA de bout en bout), video-model-scout (veille du catalogue de modèles).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.