remotion-orchestrator — Punto de entrada del paquete de habilidades Remotion
Comando único /remotion-video
/remotion-video es el comando único para videos de marketing con Remotion. Convierte un brief aproximado en un paquete de producción gobernado, una ruta de renderizado y un informe de evidencia final.
Reglas estrictas para esta ruta de comando:
- solo una voz; sin reparto múltiple ni cambio de voz por escena.
- usar únicamente las credenciales y configuración de voz existentes de Synthex ElevenLabs.
- sin nuevos proveedores, sin nuevas cuentas, sin plataformas de conexión.
- comenzar con modo simulado (dry-run) a menos que el operador solicite explícitamente renderización en producción.
- escribir
.harness/remotion/<jobId>/production-packet.json,script.md,preflight-report.mdyrender-command.sh. - nunca subir commits de MP4 generados.
El comando se enruta a través de remotion-script, remotion-production, remotion-direction, remotion-editing, remotion-integrations y remotion-professionalism, preservando el flujo de trabajo existente del paquete de habilidades Remotion a continuación.
Punto de entrada único para el paquete de habilidades Remotion — un conjunto de 10 habilidades hermanas (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) instaladas globalmente en ~/.claude/skills/remotion-* (enlazadas simbólicamente a ~/Pi-Dev-Ops/skills/remotion-*). Disponible en todos los proyectos, no solo en Pi-Dev-Ops.
Puerta de brief de descubrimiento (turno 1, obligatorio)
Adoptado de nexu-io/open-design (Apache-2.0). Antes de emitir cualquier plan de oleadas, fijar el brief. Rechazar proceder hasta que cada campo requerido esté completo — los briefs vagos producen planes de oleadas excesivamente largos y renders fuera de marca.
Campos requeridos
| Campo | Tipo | Notas |
|---|---|---|
brand | BrandSlug | Debe resolverse en src/brands/. Desconocido → enviar remotion-brand-research primero. |
composition | Explainer | Intro | SocialAd | NIRReport | ProductDemo | v1 soporta Explainer; otros retroceden con nota. |
channel | linkedin | youtube | instagram | tiktok | training | Define relación de aspecto + duración. |
aspectRatio | 1920x1080 | 1080x1920 | 1080x1080 | Por defecto según channel si se omite. |
durationSec | 15 | 30 | 60 | 90 | 120 | Define el límite de número de oleadas. |
topic | string | Una frase sobre lo que dice el video. "Video de conciencia de marca" solo es rechazado — debe nombrar el punto específico. |
audience | string | Heredado de BrandConfig.audience.primary si se omite, pero el fundador debe confirmar. |
Opcionales: school (anulación de escuela visual para el generador de color), voiceoverScript (omitir storyteller si está preescrito), referenceComposition (trabajo existente para remezclar).
Condiciones de parada dura
topicse lee como una categoría ("nuestro producto", "el lanzamiento") en lugar de una afirmación específica → bloquear.composition≠Explaineren v1 sin reconocimiento explícito de retroceso → bloquear.- Múltiples marcas nombradas en un brief → dividir en N trabajos paralelos (una por marca); nunca mezclar.
La puerta se ejecuta antes de que se compute el plan de oleadas. Un brief bloqueado nunca llega al despachador.
Invocación
El usuario puede invocar el paquete mediante:
- Decir cualquiera de: "usa el paquete de habilidades Remotion", "paquete remotion", "usa remotion".
- Nombrar cualquier habilidad individual (ej. "usa remotion-designer para revisar este diseño").
- Enviar un brief que se clasifique como
intent: "video"a través deapp/server/brief.py.
Traduce un brief en texto libre en un trabajo de renderizado estructurado y un plan de oleadas que el orquestador de Pi-Dev-Ops (app/server/orchestrator.py) despacha mediante fan-out P3-B.
El proyecto Remotion
Todas las composiciones, configuraciones de marca, ayudantes de movimiento/color y el punto de entrada de renderizado se encuentran en:
../../remotion-studio/
Al trabajar desde cualquier otro proyecto, las sub-habilidades hacen cd a esa ruta antes de leer o editar archivos de marca/composición. El punto de entrada de renderizado es npx tsx render/render.ts ... desde dentro de remotion-studio.
Disparadores
El brief contiene cualquiera de: video, explainer, promo, ad, reel, intro, outro, cta, social cut, 60s/30s/15s, render, marketing video, training video, release video, feature video, emparejado con uno de los identificadores de marca dr / disaster recovery / nrpg / ra / restoreassist / carsi / ccw / carpet cleaners warehouse.
Entradas
El planificador de Pi-Dev-Ops (Opus 4.7) llama a esta habilidad con:
brief— solicitud original en texto librerepo_url— usualmentelocal:Pi-Dev-Ops/remotion-studiolinear_team_id,linear_project_id— pre-resueltos desdeconfig/harness/projects.json
Salida
Un plan de oleadas JSON escrito en remotion-studio/.research/wave-plans/{job_id}.json con esta forma:
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"brand": "ra",
"composition": "Explainer",
"channel": "linkedin",
"durationSec": 60,
"topic": "RestoreAssist NIR Phase 1 standardisation",
"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 missing or stale"}, {"skill":"remotion-marketing-strategist"} ] },
{ "id": 2, "parallel": [ {"skill":"remotion-screen-storyteller"}, {"skill":"remotion-colour-family","if":"palette incomplete"}, {"skill":"remotion-motion-language","if":"motion missing"} ] },
{ "id": 3, "parallel": [ {"skill":"remotion-brand-codify","if":"any new brand artifacts"}, {"skill":"remotion-designer"} ] },
{ "id": 4, "serial": [ {"skill":"remotion-composition-builder"}, {"skill":"remotion-render-pipeline"} ] }
]
}
Disciplina de número de oleadas
- ≤3 oleadas para salida <30s
- ≤5 oleadas para salida ≤120s
- ≤8 oleadas para salida >120s
La sobre-descomposición es el modo de fallo contra el que esto protege.
Enrutamiento de composición (brief → composición)
| Señal del brief | Composición |
|---|---|
| "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 solo soporta Explainer. Otros IDs de composición devuelven: "{Composición} estará disponible en v1.1 — retrocediendo a Explainer con encuadre específico del canal".
Resolución de marca
Coincidir palabras clave → BrandSlug:
disaster recovery,dr→drnrpg→nrpgrestoreassist,ra,nir→racarsi→carsiccw,carpet cleaners warehouse→ccw
Si el brief nombra múltiples marcas, pedir al planificador que divida en N trabajos paralelos (una por marca) y emitir N planes de oleadas. Nunca mezclar marcas en una sola composición.
Enrutamiento Linear
Después de que la habilidad de renderizado escriba el MP4, esta habilidad (o la habilidad de renderizado) abre un ticket Linear en el proyecto mapeado desde config/harness/projects.json:
| Marca | Equipo Linear | Proyecto |
|---|---|---|
| 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) | resuelto en tiempo de ejecución |
| ccw | tiempo de ejecución | tiempo de ejecución |
Generación de miniaturas e imágenes estáticas (Canva primero — NO buscar credenciales)
Para una miniatura de video, póster o cualquier imagen estática de marketing, la ruta confiable es el MCP de Canva conectado, no una clave API de generación de imágenes en bruto:
generate-design(design_type: your_storypara 9:16,youtube_thumbnailpara 16:9) con una consulta detallada alineada con la marca — pasar la paleta/título en la consulta; Canva renderiza el texto del título de manera confiable.- Descargar las vistas previas candidatas y elegir la mejor;
create-design-from-candidate→export-design(PNG en WxH objetivo,export_quality: pro).
Reglas estrictas (aprendidas por las malas, 2026-07-01):
- Nunca buscar credenciales para claves de generación de imágenes. No escanear archivos
.envni ejecutarvercel env pullen proyectos/entornos buscandoGEMINI_API_KEY/OPENAI_API_KEY/AI_GATEWAY_API_KEY. El clasificador de modo automático lo bloquea como exploración de credenciales, y desperdicia toda la sesión. - Las variables de entorno "Sensibles" de Vercel son de solo escritura —
vercel env pulllas devuelve VACÍAS. No intentar obtener una; conseguir el valor de su fuente original o usar Canva. - Si no hay herramienta de imágenes conectada y no se puede acceder a ninguna clave en UNA verificación dirigida, detenerse y preguntar al fundador una vez — ofrecer Canva de inmediato.
- Una captura de fotograma del MP4 renderizado (ffmpeg incluido en
node_modules/@remotion/compositor-*/ffmpeg) es el plan B offline. Nota: en macOS, enlazar simbólicamente los archivos*.dylibhermanos en el directorio de trabajo para que el ffprobe/ffmpeg empaquetados se resuelvan (SIP eliminaDYLD_*).
Lo que esta habilidad NO hace
- No crea composiciones — eso es
remotion-composition-builder. - No ejecuta
npx remotion render— eso esremotion-render-pipeline. - No edita archivos BrandConfig — eso es
remotion-brand-codify.
Solo planifica + delega.
Modelo de uso por proyecto
El paquete es infraestructura compartida; cada proyecto que lo invoca proporciona su propia configuración de tiempo de ejecución y claves API.
| Aspecto | Dónde reside |
|---|---|
| Definiciones de habilidades | ~/.claude/skills/remotion-* (enlace simbólico → Pi-Dev-Ops/skills/remotion-*) — disponibles globalmente. |
| Proyecto Node de Remotion (composiciones, configs de marca, entrada de render) | ../../remotion-studio/ — sustrato compartido único. |
| Configs de marca | Synthex/packages/brand-config/src/brands/{slug}.ts — una fuente de verdad por marca, utilizada por cada proyecto que renderiza para esa marca. (Migrado de Pi-Dev-Ops/remotion-studio/src/brands/ según RA-1985 / Synthex SYN-897.) |
| Claves API (ElevenLabs, Telegram, Supabase, Linear, licencia Remotion) | El archivo .env / .env.local del proyecto que invoca. Las habilidades leen process.env al momento del renderizado. |
| Salida MP4 renderizada | El directorio .remotion-renders/ del proyecto que invoca por defecto. Sobrescribir con --out=. |
Agregar una nueva marca para tu proyecto
Si tu proyecto (ej. Synthex) necesita renderizar para una marca que aún no está en src/brands/:
- Ejecutar
remotion-brand-researchcontra las fuentes públicas de la marca. - Ejecutar
remotion-brand-codifypara producirSynthex/packages/brand-config/src/brands/{slug}.ts. - Extender la unión
BrandSlugenSynthex/packages/brand-config/src/types.ts. - Registrar en
Synthex/packages/brand-config/src/brands/index.ts. - Ejecutar
npm run typecheckdesdeSynthex/packages/brand-config/(luegonpm run buildpara regenerardist/).
Marcas actualmente registradas: dr, nrpg, ra, carsi, ccw, synthex, unite.