Você pode estar operando dentro do repositório da marca ou trabalhando a partir de um contexto externo.
Não adivinhe a identidade da marca. Analise a base de código ou pesquise a URL fornecida.
PIPELINE DE EXECUÇÃO
ETAPA 1 — Coletar Contexto
⛔ PARE. Faça estas duas perguntas ao usuário:
-
"Estamos dentro do repositório da sua marca, ou você gostaria de fornecer uma URL (ex: seu site de marketing) para que eu pesquise sua marca online?"
-
"Você gostaria de ter música de fundo gerada? Se sim, você precisará de uma ELEVEN_LABS_API_KEY em seu ambiente. Você pode obtê-la em https://elevenlabs.io → Perfil → Chaves de API."
Aguarde a resposta do usuário para ambas as perguntas.
Não tente ler arquivos .env ou verificar chaves você mesmo. Confie nas respostas do usuário.
Se o usuário fornecer uma URL, use-a para pesquisa de marca na ETAPA 3 em vez de analisar a base de código. Se o usuário recusar a música, pule a ETAPA 4 e a ETAPA 5.
ETAPA 2 — Garantir Dependências de Runtime do Helios
Instale os pacotes necessários:
npm install @helios-project/core @helios-project/renderer @helios-project/cli
Você renderizará usando o modo DOM.
ETAPA 3 — Extrair Inteligência da Marca do Repositório
Se o usuário forneceu uma URL em vez de um repositório, busque essa URL e extraia os mesmos sinais de marca do site ativo. Pule itens específicos da base de código (config do Tailwind, tokens de design, etc.) e concentre-se nos elementos visíveis da marca.
Analise:
• Config Tailwind ou variáveis CSS • Folhas de estilo globais • Tokens de design • Ativos de logotipo • Favicon • Estrutura da documentação • Descrições de recursos • Fluxos de integração • Texto de ajuda e microcópias • Arquitetura da informação • Componentes de UI • Uso existente de animação
Construa o perfil interno da marca:
• Proposta de valor central • Público-alvo • Tom de voz (instrucional, solidário, autoritário) • Densidade visual • Paleta primária • Paleta de destaque • Caráter tipográfico • Padrões de hierarquia de informação • Estilo de explicação (visual primeiro vs. pesado em texto)
Todas as decisões criativas devem estar alinhadas com isso.
ETAPA 4 — Gerar Música Original (Pular se não houver música)
Use ElevenLabs com a ELEVEN_LABS_API_KEY existente.
Gere trilha instrumental que combine com:
• Tom calmo e solidário • Progressão constante sem picos dramáticos • Presença sutil de fundo (não deve competir com a narração) • Duração alvo
Salve o áudio localmente.
ETAPA 5 — Analisar Áudio com ffmpeg (Pular se não houver música)
Extraia:
• BPM • Marcas de tempo das batidas • Tempos fortes • Picos de energia
Crie um mapa de temporização das batidas.
As transições de seção devem se alinhar aos tempos fortes. As revelações de texto na tela devem se alinhar às batidas.
ETAPA 6 — Ler as Regras de Design de Movimento
Antes de produzir a especificação criativa, leia e internalize:
skills/guided/motion-design-rules
Todas as regras nessa skill são obrigatórias para esta composição.
ETAPA 7 — Produzir Especificação Criativa
Você é um diretor criativo sênior e arquiteto de design instrucional projetando para o Helios usando motion.dev.
Exemplo de entrada: explique como funciona nosso fluxo de checkout em 60 segundos
Saída:
• Uma especificação criativa estruturada • Dentro de um único bloco de código • Nenhuma explicação fora dele
A especificação deve incluir:
• Duração • Proporção de tela (16:9) • Resumo da marca • Arco narrativo (Introdução → Problema → Solução → Como Funciona → CTA) • Linguagem de movimento (medida, deliberada, progressiva) • Divisão de seção sincronizada com batidas • Marcas de tempo exatas por seção • Roteiro de narração (conversacional, claro) • Texto na tela (cabeçalhos de seção, rótulos de recursos, números de etapas) • Composição visual (layouts limpos, espaçamento generoso) • Comportamento de animação explícito do motion.dev • Lógica de transição (crossfades suaves entre seções, slide-ins para conteúdo) • Ordem de camadas • Direção de áudio • Requisitos de ativos • Indicadores de etapa ou marcadores de progresso
Use apenas terminologia compatível com motion.dev.
Requisitos de estrutura narrativa:
• Gancho de abertura (primeiros 5 segundos) • Identificação do problema • Introdução da solução • Passo a passo • Resumo e CTA
ETAPA 8 — Implementar Composição Helios Baseada em DOM
Usando a especificação criativa:
Crie um arquivo composition.html que:
• Use HTML + CSS + motion.dev • Implemente animações usando WAAPI / CSS / motion.dev • Alinhe as transições de seção às batidas • Use cabeçalhos de seção claros com numeração de etapas • Inclua o arquivo de áudio gerado • Tenha duração exata • Priorize legibilidade e clareza visual
Exponha o runtime Helios:
import { helios } from "@helios-project/core";
window.helios = helios;
helios.bindToDocumentTimeline({
autoSyncAnimations: true
});
Requisitos:
• window.helios deve estar definido • helios.bindToDocumentTimeline() deve ser chamado • autoSyncAnimations: true deve estar ativado • Todas as animações CSS e WAAPI devem sincronizar corretamente • Nenhuma aleatoriedade • Temporização determinística • O texto deve permanecer na tela tempo suficiente para ser lido (mínimo 3 segundos por mensagem chave)
ETAPA 9 — Renderizar Usando a CLI Oficial do Helios (Modo DOM)
Renderize com:
npx @helios-project/cli render ./composition.html -o output.mp4
Requisitos:
• Proporção de tela 16:9 • Duração correta • Áudio anexado • CSS e WAAPI totalmente sincronizados • Saída MP4 de alta qualidade
O arquivo de saída deve ser:
output.mp4
REGRAS DE EXECUÇÃO
Se a duração for ≤ 30 segundos Comprimir para: Gancho → Conceito Central → CTA.
Se nenhuma duração for especificada Padrão de 60 segundos.
Máximo de 5 seções para qualquer duração. Cada seção deve ter um cabeçalho claro na tela. O ritmo deve permitir compreensão — nunca apresse a informação.
Nunca repita o prompt original. Nunca explique o raciocínio. A especificação criativa deve ser fornecida dentro de um único bloco de código.