remotion-orchestrator — Point d'entrée du Remotion Skills Package
Commande unique /remotion-video
/remotion-video est la commande unique pour les vidéos marketing Remotion. Elle transforme un brief brut en un ensemble de production régulé, un seul chemin de rendu et un rapport final.
Règles strictes pour cette commande :
- une seule voix uniquement ; pas de distribution multi-voix ni de changement de voix par scène.
- utiliser uniquement les identifiants et la configuration vocale Synthex ElevenLabs existants.
- pas de nouveaux fournisseurs, pas de nouveaux comptes, pas de plateformes de connecteurs.
- commencer par un test à sec (dry-run) sauf si l'opérateur demande explicitement un rendu de production.
- écrire
.harness/remotion/<jobId>/production-packet.json,script.md,preflight-report.mdetrender-command.sh. - ne jamais commiter les MP4 générés.
La commande transite par remotion-script, remotion-production, remotion-direction, remotion-editing, remotion-integrations et remotion-professionalism, tout en préservant le flux de travail existant du Remotion Skills Package ci-dessous.
Point d'entrée unique du Remotion Skills Package — un ensemble de 10 compétences sœurs (remotion-orchestrator, remotion-brand-research, remotion-brand-codify, remotion-designer, remotion-colour-family, remotion-motion-language, remotion-screen-storyteller, remotion-marketing-strategist, remotion-composition-builder, remotion-render-pipeline) installées globalement dans ~/.claude/skills/remotion-* (liées symboliquement vers ~/Pi-Dev-Ops/skills/remotion-*). Disponible dans tous les projets, pas seulement Pi-Dev-Ops.
Portail de découverte du brief (tour 1, obligatoire)
Adopté de nexu-io/open-design (Apache-2.0). Avant qu'un plan par vagues ne soit émis, verrouillez le brief. Refusez de continuer tant que tous les champs obligatoires ne sont pas remplis — les briefs vagues produisent des plans par vagues trop longs et des rendus hors marque.
Champs obligatoires
| Champ | Type | Notes |
|---|---|---|
brand | BrandSlug | Doit être résolu dans src/brands/. Inconnu → déclencher remotion-brand-research d'abord. |
composition | Explainer | Intro | SocialAd | NIRReport | ProductDemo | v1 prend en charge Explainer uniquement ; les autres se replient avec une note. |
channel | linkedin | youtube | instagram | tiktok | training | Définit le ratio d'aspect et la discipline de durée. |
aspectRatio | 1920x1080 | 1080x1920 | 1080x1080 | Par défaut selon channel si omis. |
durationSec | 15 | 30 | 60 | 90 | 120 | Définit le nombre maximal de vagues. |
topic | chaîne | Une phrase sur ce que dit la vidéo. "Vidéo de notoriété de marque" seul est refusé — le point spécifique doit être nommé. |
audience | chaîne | Hérité de BrandConfig.audience.primary si omis, mais le fondateur doit confirmer. |
Optionnel : school (remplacement de l'école visuelle pour le générateur de couleurs), voiceoverScript (sauter le storyteller si pré-écrit), referenceComposition (tâche existante à remixer).
Conditions d'arrêt strict
topicse lit comme une catégorie ("notre produit", "le lancement") plutôt qu'une affirmation spécifique → bloquer.composition≠Explaineren v1 sans accusé de réception explicite de repli → bloquer.- Plusieurs marques nommées dans un même brief → diviser en N tâches parallèles (une par marque) ; ne jamais mélanger.
Le portail s'exécute avant que le plan par vagues ne soit calculé. Un brief bloqué n'atteint jamais le répartiteur.
Invocation
L'utilisateur peut invoquer le package en :
- disant n'importe lequel de : "utiliser le Remotion Skills Package", "package remotion", "utiliser remotion".
- nommant une compétence individuelle (ex : "utiliser remotion-designer pour QA cette mise en page").
- soumettant un brief qui se classifie comme
intent: "video"viaapp/server/brief.py.
Traduit un brief en texte libre en une tâche de rendu structurée et un plan par vagues que l'orchestrateur Pi-Dev-Ops (app/server/orchestrator.py) répartit via P3-B fan-out.
Le projet Remotion
Toutes les compositions, configurations de marque, aides au mouvement/couleur et le point d'entrée de rendu se trouvent dans :
../../remotion-studio/
Lorsque vous travaillez depuis un autre projet, les sous-compétences exécutent cd vers ce chemin avant de lire ou modifier les fichiers de marque / composition. Le point d'entrée de rendu est npx tsx render/render.ts ... depuis remotion-studio.
Déclencheurs
Le brief contient l'un des mots suivants : video, explainer, promo, ad, reel, intro, outro, cta, social cut, 60s/30s/15s, render, marketing video, training video, release video, feature video, associé à l'un des identifiants de marque dr / disaster recovery / nrpg / ra / restoreassist / carsi / ccw / carpet cleaners warehouse.
Entrées
Le planificateur Pi-Dev-Ops (Opus 4.7) appelle cette compétence avec :
brief— la requête originale en texte librerepo_url— généralementlocal:Pi-Dev-Ops/remotion-studiolinear_team_id,linear_project_id— pré-résolus depuisconfig/harness/projects.json
Sortie
Un plan par vagues JSON écrit dans remotion-studio/.research/wave-plans/{job_id}.json avec cette structure :
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"brand": "ra",
"composition": "Explainer",
"channel": "linkedin",
"durationSec": 60,
"topic": "Standardisation de la phase 1 NIR de RestoreAssist",
"linear": { "teamId": "...", "projectId": "..." },
"outputPath": "output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
"waves": [
{ "id": 1, "parallel": [ {"skill":"remotion-brand-research","if":"brands/ra.ts manquant ou obsolète"}, {"skill":"remotion-marketing-strategist"} ] },
{ "id": 2, "parallel": [ {"skill":"remotion-screen-storyteller"}, {"skill":"remotion-colour-family","if":"palette incomplète"}, {"skill":"remotion-motion-language","if":"mouvement manquant"} ] },
{ "id": 3, "parallel": [ {"skill":"remotion-brand-codify","if":"nouveaux artefacts de marque"}, {"skill":"remotion-designer"} ] },
{ "id": 4, "serial": [ {"skill":"remotion-composition-builder"}, {"skill":"remotion-render-pipeline"} ] }
]
}
Discipline du nombre de vagues
- ≤3 vagues pour une sortie <30s
- ≤5 vagues pour une sortie ≤120s
- ≤8 vagues pour une sortie >120s
La sur-décomposition est le mode de défaillance contre lequel cela protège.
Routage de composition (brief → composition)
| Signal du brief | composition |
|---|---|
| "explainer", "feature video", "how it works" | Explainer |
| "intro", "title card", "channel opener" | Intro (v1.1) |
| "ad", "promo", "reel", "social cut", "Instagram", "TikTok" | SocialAd (v1.1) |
| "NIR report", "inspection report", RA + "report" | NIRReport (v1.1) |
| "demo", "product walkthrough" | ProductDemo (v1.1) |
v1 prend en charge Explainer uniquement. Les autres identifiants de composition renvoient : "{Composition} sera disponible en v1.1 — repli sur Explainer avec un cadrage spécifique au canal".
Résolution de marque
Faire correspondre les mots-clés → BrandSlug :
disaster recovery,dr→drnrpg→nrpgrestoreassist,ra,nir→racarsi→carsiccw,carpet cleaners warehouse→ccw
Si le brief nomme plusieurs marques, demandez au planificateur de diviser en N tâches parallèles (une par marque) et d'émettre N plans par vagues. Ne jamais mélanger les marques dans une seule composition.
Routage Linear
Après que la compétence de rendu ait écrit le MP4, cette compétence (ou la compétence de rendu) ouvre un ticket Linear dans le projet mappé depuis config/harness/projects.json :
| Marque | Équipe Linear | projet |
|---|---|---|
| ra | a8a52f07-63cf-4ece-9ad2-3e3bd3c15673 (RA) | 3c78358a-b558-4029-b47d-367a65beea7b |
| dr / nrpg | 43811130-ac12-47d3-9433-330320a76205 (DR) | d2c1d63b-1e85-424d-9278-efff15b0d46b |
| carsi | 91b3cd04-... (GP) | résolu à l'exécution |
| ccw | exécution | exécution |
Génération de vignettes et d'images fixes (Canva d'abord — NE PAS chercher des identifiants)
Pour une vignette vidéo, une affiche ou toute image marketing statique, le chemin fiable est le Canva MCP connecté, pas une clé d'API de génération d'image brute :
generate-design(design_type: your_storypour 9:16,youtube_thumbnailpour 16:9) avec une requête détaillée alignée sur la marque — passer la palette/le titre dans la requête ; Canva rend le texte du titre de manière fiable.- Télécharger les aperçus candidats et choisir le meilleur ;
create-design-from-candidate→export-design(PNG aux dimensions cibles,export_quality: pro).
Règles strictes (apprises à la dure, 2026-07-01) :
- Ne jamais chercher des identifiants pour les clés de génération d'images. Ne pas analyser les fichiers
.envni exécutervercel env pulldans les projets/environnements à la recherche deGEMINI_API_KEY/OPENAI_API_KEY/AI_GATEWAY_API_KEY. Le classifieur en mode automatique le bloque comme exploration d'identifiants, et cela gaspille toute la session. - Les variables d'environnement Vercel "Sensibles" sont en écriture seule —
vercel env pullles renvoie VIDES. Ne pas essayer d'en récupérer une ; obtenir la valeur de sa source d'origine ou utiliser Canva. - Si aucun outil d'image n'est connecté et qu'aucune clé n'est accessible en UNE vérification dirigée, arrêtez-vous et demandez une fois au fondateur — proposez Canva dès le départ.
- Une capture d'écran du MP4 rendu (ffmpeg fourni dans
node_modules/@remotion/compositor-*/ffmpeg) est le repli hors ligne. Note : sur macOS, créez un lien symbolique des fichiers*.dylibfrères dans le répertoire de travail pour que ffprobe/ffmpeg fournis se résolvent (SIP supprimeDYLD_*).
Ce que cette compétence NE fait PAS
- N'écrit pas de compositions — c'est
remotion-composition-builder. - N'exécute pas
npx remotion render— c'estremotion-render-pipeline. - Ne modifie pas les fichiers BrandConfig — c'est
remotion-brand-codify.
Elle ne fait que planifier + déléguer.
Modèle d'utilisation par projet
Le package est une infrastructure partagée ; chaque projet appelant fournit sa propre configuration d'exécution et ses propres clés API.
| Élément | Emplacement |
|---|---|
| Définitions des compétences | ~/.claude/skills/remotion-* (lié symboliquement → Pi-Dev-Ops/skills/remotion-*) — disponibles globalement. |
| Projet Node Remotion (compositions, configs de marque, point d'entrée de rendu) | ../../remotion-studio/ — substrat unique partagé. |
| Configurations de marque | Synthex/packages/brand-config/src/brands/{slug}.ts — une source de vérité par marque, utilisée par chaque projet qui rend pour cette marque. (Migré depuis Pi-Dev-Ops/remotion-studio/src/brands/ selon RA-1985 / Synthex SYN-897.) |
| Clés API (ElevenLabs, Telegram, Supabase, Linear, licence Remotion) | Le fichier .env / .env.local du projet appelant. Les compétences lisent process.env au moment du rendu. |
| Sortie MP4 rendue | Le répertoire .remotion-renders/ du projet appelant par défaut. Remplacez avec --out=. |
Ajouter une nouvelle marque pour votre projet
Si votre projet (ex : Synthex) a besoin de rendre pour une marque qui n'est pas encore dans src/brands/ :
- Exécutez
remotion-brand-researchsur les sources publiques de la marque. - Exécutez
remotion-brand-codifypour produireSynthex/packages/brand-config/src/brands/{slug}.ts. - Étendez l'union
BrandSlugdansSynthex/packages/brand-config/src/types.ts. - Enregistrez dans
Synthex/packages/brand-config/src/brands/index.ts. - Exécutez
npm run typecheckdepuisSynthex/packages/brand-config/(puisnpm run buildpour régénérerdist/).
Marques actuellement enregistrées : dr, nrpg, ra, carsi, ccw, synthex, unite.