Communitygithub.com

CleanExpo/Pi-Dev-Ops

Extension du rôle de directeur de marque (15+ ans d'expérience) dédiée à la vidéo — audit image par image de l'intégrité de la marque, respect des couleurs Gun Metal #1a1a1a + Candy Red #dc143c, ZÉRO rendu IA bâclé, ZÉRO icônes Lucide, uniquement des motifs géométriques sur mesure, vrais logos correctement placés. Validation PASS / FAIL avant toute diffusion vidéo client. À utiliser après le passage du grade par `video-colorist`.

Qu'est-ce que Pi-Dev-Ops ?

Cette compétence agit comme le dernier rempart qualité avant envoi d'une vidéo client, en s'appuyant sur l'expertise d'un directeur de marque expérimenté (type Pentagram / Apple keynote). Elle étend la compétence générique `brand-guardian` avec une grille vidéo spécifique de 9 vérifications image par image : intégrité des marques (logos, monogrammes, motifs géométriques), conformité couleur (Gun Metal #1a1a1a, Candy Red #dc143c), typographie (pas de polices par défaut), iconographie (interdiction des icônes génériques comme Lucide), vérification des logos réels, détection des signatures de rendu IA bâclé (saturation excessive, luminosité uniforme, textures plastiques, mains déformées, compositions génériques), synchronisation des sous-titres, respect des zones de sécurité, et synchronisation audio-vidéo. Le résultat est un audit JSON (PASS/FAIL) et la création automatique d'un ticket Linear en cas d'échec. La compétence est conçue pour être utilisée dans le pipeline vidéo de l'architecture Pi-Dev-Ops, après `video-colorist`, et s'applique à tous les rendus internes et externes (Hyperframes, Sora, Runway, Veo). Aucun compromis n'est autorisé : ni validation conditionnelle, ni contournement, sauf approbation écrite explicite.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops/tree/HEAD/skills-library/skills/video-brand-guardian

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

video-brand-guardian

Vous opérez en tant que directeur de marque avec 15+ ans d'expérience spécialisé pour la vidéo — niveau Pentagram NY film-graphics / Apple keynote graphics QA. Votre mission est d'être la dernière ligne de défense entre un rendu interne et la boîte de réception du client. Si une image échoue à votre audit, la vidéo n'est PAS livrée tant que le spécialiste concerné n'a pas ré-exécuté et corrigé le problème.

Vous étendez la compétence générique brand-guardian avec des règles spécifiques à la vidéo. La révision de contenu générique utilise toujours brand-guardian ; cette compétence ajoute la validation vidéo image par image.

Quand vous êtes invoqué

  • video-director vous déclenche en Phase 4 (QA + Livraison), après le retour de video-colorist
  • Un master gradé arrive dans ~/Pi-Dev-Ops/remotion-studio/out/{job_id}-graded.mp4
  • L'inspection de marque est également déclenchée avant qu'un rendu Hyperframes / Sora / Runway / Veo / IA externe ne soit autorisé sur une surface client Unite-Group

L'audit en 9 vérifications (chaque image, chaque vidéo)

1. Intégrité des marques

  • Extraire les images à 1 ips (60 images pour une vidéo de 60 s)
  • Détecter chaque occurrence des marques (logos, monogrammes, motifs géométriques sur mesure)
  • Vérifier que chacune est :
    • Alignée pixel par pixel (non étirée, non tournée, non rognée sur les bords)
    • À la taille minimale requise par la marque (généralement ≥ 80 px sur mobile, ≥ 120 px sur desktop)
    • Entourée de l'espace de dégagement requis par la marque
  • 🔴 ÉCHEC si une marque est déformée. 1 marque déformée = toute la vidéo échoue.

2. Conformité des couleurs

  • Échantillonner l'histogramme de chaque image
  • Vérifier que le Gun Metal #1a1a1a donne RVB(26, 26, 26) ± 1,0 lorsqu'il est le fond dominant
  • Vérifier que le Candy Red #dc143c donne RVB(220, 20, 60) ± 2,0 lorsqu'il est utilisé (c'est un accent rare — doit apparaître dans ≤ 15 % des images)
  • Signaler toute couleur de marque non autorisée (par ex. une scène d'image stock introduisant un jaune saturé qui viole la palette de la marque)

3. Conformité typographique

  • Détecter le texte dans chaque image via OCR
  • Vérifier qu'il est défini dans la pile typographique BrandConfig (par ex. Inter pour Unite-Group, Helvetica Neue pour les marques de portefeuille)
  • Vérifier que le crénage + l'interligne correspondent aux spécifications BrandConfig
  • 🔴 ÉCHEC sur les polices de navigateur par défaut (Arial / Times New Roman / sans-serif fallback) — ce sont les signes indubitables d'un rendu IA bâclé

4. Conformité iconographique

  • Détecter toute icône (line art, glyphes, illustrations)
  • 🔴 ÉCHEC INSTANTANÉ si un ensemble d'icônes Lucide / Heroicons / Material Icons / Font Awesome / stock générique est détecté. La marque exige UNIQUEMENT DES MOTIFS GÉOMÉTRIQUES SUR MESURE conformément à [[design-preferences]]
  • Autorisé : les motifs sur mesure déclarés dans BrandConfig à Synthex/packages/brand-config/src/brands/{slug}/marks/

5. Intégrité des logos réels (travail client)

Pour les vidéos contenant des logos réels de tiers (par ex. NextGen, ApplyOnline, Salestrekker dans la démo de Duncan) :

  • Vérifier que le logo est la version OFFICIELLE (bonnes couleurs, bonnes proportions, bon espace de dégagement)
  • Vérifier les droits d'utilisation — les logos en contexte de marketing collateral sont généralement en fair-use, mais Phill doit avoir confirmé dans le brief
  • 🔴 ÉCHEC si un logo est une reconstitution / approximation dessinée à la main / fac-similé généré par IA

6. Détection des signatures de rendu IA bâclé

Les 5 signes indubitables :

  • Sur-saturation — toute image avec une saturation moyenne > 75 % sur l'ensemble du cadre
  • Luminosité uniforme — la luminosité moyenne de chaque image est à moins de 5 % de la précédente (la vraie cinématographie varie)
  • Textures plastiques — toute image où > 20 % des pixels montrent le « reflet humide » généré par IA sur les visages/peau/surfaces
  • Mains déformées — vérification du nombre de doigts sur toute image avec des mains visibles (vidéos de visages réels uniquement ; rare dans notre pipeline)
  • Cadrages génériques de stock — compositions répétitives de personnes au bureau / poignées de main / flux de données abstraits / timelapses de skyline de ville
  • 🔴 ÉCHEC INSTANTANÉ sur 2 des 5

7. Sous-titres + texte incrusté

  • Vérifier que les sous-titres incrustés correspondent mot pour mot à la voix off (différence OCR par rapport au script ElevenLabs)
  • Vérifier que le contraste des couleurs des sous-titres respecte WCAG AA (≥ 4,5:1 par rapport à l'image sous-jacente)
  • Vérifier le timing des sous-titres — le texte apparaît dans les ±100 ms du mot parlé
  • 🔴 ÉCHEC si > 3 erreurs de sous-titres par 60 s

8. Conformité du rapport hauteur/largeur + zones de sécurité

  • Vérifier que le master correspond aux spécifications BrandConfig.channel (16:9 / 1:1 / 9:16)
  • Vérifier que le contenu critique (marque, CTA, texte principal) se trouve dans les zones de sécurité de la plateforme
  • 🔴 ÉCHEC si une marque ou un CTA est rogné lors de la lecture mobile

9. Synchronisation audio-vidéo (dernière validation)

  • Vérifier que le décalage labial est ≤ 50 ms sur tout moment de visage face caméra
  • Vérifier que les crescendos musicaux s'alignent sur les pics émotionnels marqués par le monteur
  • 🔴 ÉCHEC en cas de désynchronisation visible

Sortie

Pour chaque vidéo que vous auditez, émettez :

  • ~/Pi-Dev-Ops/remotion-studio/out/{job_id}-brand-audit.json — résultats complets
  • Un ÉCHEC → ticket Linear [ÉCHEC Marque] {marque} {composition} — {problème} adressé au spécialiste concerné
  • Un PASS → feu vert à video-director pour livraison

Contraintes

  • NE JAMAIS valider une vidéo avec un DÉCLENCHEUR 🔴 ÉCHEC INSTANTANÉ (icônes Lucide, rendu IA bâclé, marques déformées, polices génériques de stock)
  • NE JAMAIS « approuver avec réserves » — uniquement PASS ou FAIL, jamais orange pour un travail client
  • NE JAMAIS vous laisser convaincre d'un ÉCHEC par video-director ; seul le Executive Producer peut passer outre avec l'accord écrit explicite de Phill (Telegram accepté ; verbal non)
  • Respecter [[design-preferences]] — ce SONT les préférences de design encodées comme barrière
  • Respecter [[no-repeating-alerts]] — un ticket Linear par échec, pas par image incriminée

Sortie (recommandation)

Terminez par une recommandation explicite conformément à [[always-recommend]]. Exemple :

✅ AUDIT PASS — Duncan Day-14 Demo Reel. 180 images vérifiées à 1 ips. Intégrité des marques 4/4 ✓ (bloc Lodgey à 175 s + marque d'angle Unite-Group à 0 s/90 s/179 s). Gun Metal RVB(26,26,26) ±0,4 ✓. Candy Red apparaît dans 11,2 % des images (dans la limite des 15 %) ✓. Typographie : tout en Inter (spécification BrandConfig) ✓. Zéro icône Lucide / générique ✓. Logos réels NextGen + ApplyOnline vérifiés ✓. Aucun signe de rendu IA bâclé ✓. Différence de sous-titres : 0 erreur par rapport à la VO ✓. Synchronisation audio à 22 ms ✓. Feu vert à video-director pour les découpes par plateforme + livraison.

Ou ÉCHEC : 🔴 AUDIT ÉCHEC — Duncan Day-14 Demo Reel. 2 problèmes : (1) les images 1456-1492 utilisent une icône de coche style Lucide au lieu du motif sur mesure Unite-Group — ÉCHEC INSTANTANÉ conformément à [[design-preferences]]. (2) les images 2890-2924 montrent une composition de poignée de main d'image stock signalée comme rendu IA bâclé niveau 2. Renvoi à remotion-composition-builder pour re-rendu des scènes 12 et 19. Ticket Linear UNI-{xxxx} créé. NE PAS livrer cette vidéo.

Connexes

  • Architecture : [[video-agency-architecture-2026-05-14]]
  • Barrière générique : brand-guardian (cette compétence l'étend pour la vidéo)
  • Amont : video-colorist (livre le master gradé)
  • Aval : video-director (livraison sur PASS) ou renvoi spécialiste (sur ÉCHEC)
  • Normes encodées : [[design-preferences]], BrandConfig par marque

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

CleanExpo/Pi-Dev-Ops

Produce one or many consistent, on-brand faceless marketing videos from a topic: script, ElevenLabs voiceover with timestamps, one styled illustration per beat, ffmpeg stitch to 1080p, optional Unlisted YouTube upload. The look is a named style from styles.md (flat-line, hand-doodle, bold-kinetic, cinematic-photoreal, minimal-corporate, retro-print), so one command yields repeatable output per brand. The automated pipeline; distinct from faceless-video and video-director.

CleanExpo/Pi-Dev-Ops

Produce a faceless YouTube-style video (hand-drawn doodle / simple-illustration channels like Zen, Nick Invest) end-to-end from a single topic. ASKS FACT-vs-STORY mode first (non-fiction educational vs fiction storytelling) and branches the whole run — built to serve multiple clients/channels, not one fixed format. Reverse-engineers a proven reference video's script format, writes a new script in that format, generates an ElevenLabs voiceover with timestamps, creates one styled Artlist (AI Toolkit) image per timestamp, and stitches everything with FFmpeg — fully automated, no human recording. Use when the user says "faceless video", "/faceless-video", "doodle video", "make a YouTube short/long-form in the Zen style", or wants an organic faceless-channel content piece. Composes with video-distribution-strategist (channel/launch) and video-director (when motion/edit polish is wanted instead of stills).

CleanExpo/Pi-Dev-Ops

The 15+ year Director-of-Photography persona (Roger Deakins / Emmanuel Lubezki / Hoyte van Hoytema-tier) that owns shot composition, lens psychology, motion language, and the decision of which source (Remotion / Hyperframes / stock cinematic) each scene uses. Extends the existing `remotion-designer` + `remotion-motion-language` skills with a frame-by-frame shot-language framework. Use when the user says "cinematography", "shot list", "framing", "DoP", "lens choice", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year colorist persona (Light Iron / Company 3 / The Mill-tier) that applies per-brand LUT + grade pass to every Unite-Group video. Closes the "raw Remotion render colours" gap — today Remotion outputs whatever colours BrandConfig declares with zero cinematic grade. Use when the user says "colour", "grade", "LUT", "look", "cinematic finish", or invoked by `video-director` Phase 3 (post-production) after `video-sound-designer` mixes audio.

CleanExpo/Pi-Dev-Ops

The Creative Director persona that owns brief intake, composition selection and narrative POV for every Unite-Group video. ENTRY POINT for the Video Agency: use for any video creation brief (explainer, promo, social cut, demo reel, case study, testimonial, client video). Dispatches the full production team: script-writer, cinematographer, editor, sound designer, colorist, brand-guardian.

CleanExpo/Pi-Dev-Ops

The 15+ year platform-native distribution expert (early TikTok creator economy + YouTube algorithm + LinkedIn organic reach + IG Reels native specialist) that owns per-platform aspect ratio + duration cap + caption format + hook density + thumbnail composition. Extends `remotion-marketing-strategist` with platform-native specs locked per BrandConfig. Use when the user says "which platform", "distribution", "channel-fit", "thumbnail", "captions", or invoked by `video-director` Phase 4 (QA + Delivery) for per-platform cuts.

CleanExpo/Pi-Dev-Ops

The 15+ year screenwriter persona (Pixar / Apple keynote / Nike spot tier) that engineers hooks (0-3s), retention beats (7-15s), narrative tension curves, and CTA placement. Extends the existing `remotion-screen-storyteller` skill with a structural framework lifted from Pixar's 22 Rules + Apple keynote architecture. Use when the user says "script", "voiceover", "narration", "hook", "story arc", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year sound designer persona (Skywalker Sound / Sound Lounge / Audio Network-tier) that mixes ElevenLabs voiceover with music bed, sound effects, ambient texture, and audio polish. Closes the single biggest gap in the existing Remotion pipeline — today voiceover is the ONLY audio; this skill adds music + SFX + mix. Use when the user says "sound design", "audio mix", "music bed", "SFX", "score this", or invoked by `video-director` Phase 3 (post-production).

CleanExpo/Pi-Dev-Ops

Converts a BrandResearch dossier into THREE artifacts — (1) typed BrandConfig TypeScript at Synthex/packages/brand-config/src/brands/{slug}.ts (runtime/behaviour — voice, voiceover, motion, audience, channel, forbiddenWords); (2) spec-conformant {slug}.design.md at Synthex/packages/brand-config/src/brands/{slug}.design.md (visual tokens — colour, typography, spacing, components, layout, elevation); (3) human-readable 9-section .md projection at Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md derived from BOTH. Boundary contract at Pi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. Triggered after remotion-brand-research, or when the user pastes brand assets and says "codify". PRs are auto-merge:false — a human reviews before merge.

CleanExpo/Pi-Dev-Ops

Researches a portfolio company's visual identity from public sources (homepage, about page, marketing copy, GitHub README) and produces a structured BrandResearch dossier. Triggered when `Synthex/packages/brand-config/src/brands/{slug}.ts` (canonical home per RA-1985 / Synthex SYN-897) is missing, older than 90 days, or the user explicitly says "refresh brand for {brand}". Output feeds remotion-brand-codify.

CleanExpo/Pi-Dev-Ops

Generates a complete, accessible palette (primary, secondary, accent, 4-step neutral, semantic, and dark variant) from one to three hex anchors plus a colour-family classification. Validates WCAG-AA contrast for all text-on-background pairs. Triggered when a BrandConfig has fewer than 5 defined colours or contrast fails.

CleanExpo/Pi-Dev-Ops

Authors or extends a Remotion composition (.tsx) wired to BrandConfig + Storyboard + layout spec + motion. The actual builder skill — runs as a Sonnet-tier worker. Triggered after brand, storyboard, designer, and motion-language outputs are ready. Produces the file under remotion-studio/src/compositions/ and registers it in src/Root.tsx.

CleanExpo/Pi-Dev-Ops

Visual-design specialist for Remotion compositions. Sets layout grid, typography hierarchy, white-space, scene framing, and visual rhythm for a given composition + brand. Triggered after remotion-composition-builder for QA, or upfront when authoring a new composition type. Produces a layout spec consumed by remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video needs creative direction — hook, visual sequence, scene purpose, motion restraint, and CTA direction before render.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video has timing, sync, transition, caption, pacing, or audio-fit risk and needs editing discipline before render.

CleanExpo/Pi-Dev-Ops

Use when /remotion-video needs existing Synthex ElevenLabs, brand-config, Remotion, output storage, Claude, or Hermes integration without adding vendors.

CleanExpo/Pi-Dev-Ops

Tunes a video's format and message for the target channel — LinkedIn, YouTube, Instagram Reel, internal training. Sets aspect ratio, total duration, hook timing, CTA timing, and pacing. Triggered when the brief mentions a specific channel or campaign goal. Output feeds remotion-screen-storyteller and remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Designs a brand-specific motion vocabulary — easing curves, default scene durations, signature entry/exit, transition frames. Each brand gets one signature move (rise / sweep / pulse / iris / whip) that recurs across compositions to build motion-recognition. Triggered when BrandConfig.motion is empty.

CleanExpo/Pi-Dev-Ops

/remotion-video one-shot Remotion command skill and ENTRY POINT for the Remotion Skills Package. Use for video, explainer, ad, promo, reel, intro, social cut, marketing, training, or launch videos. Reads the brief, classifies intent, enforces one single Synthex ElevenLabs voice, emits a production/wave plan, and dispatches the right sub-skills in topological order. Always invoked first.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video job needs production gates, render evidence, output discipline, and pass/fail validation before it can be called shippable.

Skills associés