remotion-render-pipeline
Transforma a composição em um MP4 entregue.
Gatilhos
remotion-composition-builderreportaready: true.- O usuário diz "renderiza isso" / "entrega isso" com um job conhecido.
Entradas
jobIdcomposition— id correspondente asrc/Root.tsx(ex.:Explainer)outputPath— relativo aremotion-studio/output/props— todas as props de entrada completas (marca + storyboard + ...) como JSONlinear—{teamId, projectId}para roteamento de tickets
Método
- Verificação de tipos pré-voo —
cd remotion-studio && npx tsc --noEmit. Em caso de erro, retorna pararemotion-composition-buildercom o erro. - Síntese de narração —
render/voiceover.tsescreve MP3s por cena empublic/audio/{jobId}/scene-N.mp3(dentro depublic/para questaticFile()as resolva). Usa chave de cachesha1(voiceId|style|text). Ignora seELEVENLABS_API_KEYestiver faltando — a composição ainda deve renderizar apenas com texto na tela. - Renderização —
npx tsx render/render.ts --comp={composition} --out={outputPath} --props='{...}' --jobId={jobId}. Envolve em um timeout de 600s; uma repetição em caso de travamento/quebra. - Validação — arquivo existe, duração ±0,5s da esperada, codec
h264, resolução corresponde à composição, tamanho <100MB. - Entrega:
- Envia para o bucket Supabase
remotion-renders— URL assinada, retenção de 90 dias. - Telegram via
app.server.telegram_video.send_telegram_video()(utilidade compartilhada). Se o arquivo >45MB, envia o link da URL assinada em vez do upload inline (limite do Telegram é 50MB). - Abre um ticket no Linear em
{teamId}/{projectId}com: URL da renderização, resumo da origem, versão do BrandConfig (git sha desrc/brands/{slug}.ts), caminho do arquivo de composição.
- Envia para o bucket Supabase
- Status — escreve resumo em
.research/renders/{jobId}.json.
Saída
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"mp4Path": "remotion-studio/output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
"supabaseUrl": "https://<project>.supabase.co/storage/v1/object/sign/remotion-renders/...",
"telegramSent": true,
"linearIssue": "RA-2049",
"validation": { "durationSec": 60.0, "codec": "h264", "resolution": "1920x1080", "sizeMB": 12.4 }
}
Limites
- Nunca execute a renderização com
tsc --noEmitfalhando — desperdiça 2-5 minutos para uma saída garantidamente ruim. - Nunca faça merge automático do PR de origem (mudanças de composição + marca) antes que a verificação da renderização passe.
- Nunca envie renders com
[DRAFT]incorporado para o bucket de marcas — rascunhos vão pararemotion-drafts.
Escalonamento de falhas
- Timeout / travamento → mata, tenta novamente uma vez → se segunda falha, abre Linear com
priority: 2, anexa stderr. - Falha de validação (duração/codec errados) → Linear
priority: 3com diff vs. esperado. - Falha no Telegram → recua para
send_telegram_document()com.mp4como anexo.
Reutilizado
render/render.tsrender/voiceover.tsapp/server/telegram_video.py(utilidade compartilhada)config/harness/projects.jsonpara resolução de time/projeto do Linear
Chaves de API por projeto
Este skill é invocado de dentro do projeto chamador (Synthex, Pi-SEO, RestoreAssist, qualquer um). Cada projeto fornece suas próprias chaves por meio de seu próprio .env / .env.local. O skill nunca lê chaves do Pi-Dev-Ops.
Variáveis de ambiente obrigatórias ou com aviso no momento da renderização:
ELEVENLABS_API_KEY— síntese de narração. Faltando = renderização silenciosa apenas com texto na tela (aviso registrado, renderização continua).TELEGRAM_BOT_TOKEN,TELEGRAM_CHAT_ID— entrega via Telegram. Faltando = pula etapa do Telegram (o MP4 ainda chega ao disco + Supabase se configurado).SUPABASE_URL,SUPABASE_SERVICE_ROLE_KEY— upload de URL assinada. Faltando = pula etapa do Supabase.LINEAR_API_KEY— criação de ticket. Faltando = pula etapa do Linear.REMOTION_LICENSE_KEY— necessário para qualquer renderização comercial sob a licença fair-source do Remotion.
Padrão de invocação a partir do shell do projeto:
cd ~/Pi-CEO/Synthex
source .env.local # chaves do próprio projeto
cd ~/Pi-Dev-Ops/remotion-studio
npx tsx render/render.ts \
--comp=Explainer \
--out=$OLDPWD/.remotion-renders/synthex-launch.mp4 \
--jobId=synthex-launch-$(date +%s) \
--props='{"brand":"synthex","hookSec":8,"ctaSec":8,"storyboard":[...]}'
Ou invoque por meio da API orquestradora do Pi-Dev-Ops, que herda o ambiente do projeto chamador no momento da criação da sessão.
Convenção de saída: escreva o MP4 dentro de <projeto-chamador>/.remotion-renders/ (gitignorado) por padrão — mantém os artefatos de cada projeto em sua própria árvore. Substitua com --out=....