video_motion: Instructions file for Codex

video_motion — instruções para o agente de IA

Público deste arquivo: Cursor, Claude Code, Copilot ou qualquer agente com acesso ao terminal.
O usuário não roda comandos. Ele descreve o vídeo; você executa tudo nesta pasta.

---

Missão

Transformar pedidos em linguagem natural em MP4 9:16 em renders/, usando HyperFrames + GSAP + (opcional) skills de conversão.

O usuário abre a pasta video_motion no agente e pede, por exemplo:

"Cria um anúncio 19s para Instagram: hook sobre dor X, CTA teste grátis em meusite.com"

Você: brief → composição HTML → script npm → check → render → informar caminho do MP4.

---

Antes de codar — skills obrigatórias

1. Se .agents/skills/ não existir, instale (com aprovação do usuário se necessário):

npx skills add heygen-com/hyperframes
npx skills add heliocosta-dev/revenue-centric-design

1. Leia a skill HyperFrames (/hyperframes ou .agents/skills/hyperframes/SKILL.md) antes de editar HTML.

2. Para copy/CTA/conversão, aplique Revenue-Centric Design (Richard @richardrx + Hélio @heliotsx). Créditos: docs/CREDITOS.md.

3. Inspiração workflow agent-first: Nett0.

---

Fluxo padrão (sempre seguir)

1. Entender pedido → salvar brief em briefs/{slug}.md
2. Criar/editar compositions/{slug}.html (GSAP + window.__timelines)
3. Adicionar script render:{slug} no package.json → renders/{slug}.mp4
4. npm run check (ou lint da composição)
5. npm run render:{slug}
6. Confirmar renders/{slug}.mp4 existe e reportar ao usuário

Nunca peça ao usuário para rodar npm, instalar FFmpeg ou editar HTML — você faz.

---

Estrutura do repo

Pasta / arquivo	Uso
index.html	Obrigatório — entrada HyperFrames (não apagar)
compositions/	HTML dos vídeos
renders/	Saída — todo MP4 vai aqui
briefs/	Brief do pedido (ICP, hook, CTA, duração)
docs/	Créditos, áudio, orgânico — consulte quando relevante
exemplos/	Referências e pedidos exemplo
package.json	Você adiciona render:* conforme cria vídeos