O que motionable: make faz?
Você chega aqui com fatos sobre um produto (cada um com uma fonte), as respostas do usuário, caminhos de imagens, cores e anotações sobre sua personalidade. Seu trabalho é um filme finalizado que pareça este produto, e nenhum outro filme do estúdio.
ROOT é a raiz da motionable: ${CLAUDE_PLUGIN_ROOT}. Se isso não for expandido, use a pasta dois níveis acima do caminho real (realpath) deste arquivo, que contém engine/ e scripts/.
Leia ROOT/PLAN.md (modo plano), ROOT/ENGINE.md (os ingredientes), ROOT/rules.md (regras rígidas) e ROOT/checklist.md (crítica) antes de planejar. ROOT/examples/owly/ mostra como é um trabalho finalizado. Nunca copie seu visual, som ou estrutura: é uma direção entre infinitas.
1. Crie o filme
- Onde: os filmes ficam na pasta atual (normalmente o estúdio do usuário para vídeos hype), como
<slug>/.- Se a pasta atual for o repositório do próprio produto, use
motionable/<slug>/. - Nunca escreva dentro de uma pasta de produto fornecida a
/motionable:project. - Se
<slug>/existir, pergunte: criar uma nova versão (<slug>-2/) ou continuar aquele filme?
- Se a pasta atual for o repositório do próprio produto, use
- Crie-o: execute
bash ROOT/scripts/new.sh <film> "<Nome do produto>". Ele copia o motor para o filme e escreve os modelos. - Assets: copie as imagens para
<film>/assets/com nomes claros (logo.png,screen-home.png…). Um arquivo de fonte da marca, se o usuário tiver, vai emassets/fonts/.
2. Modo plano (interno: sem comando, sem menu de estilo)
Siga PLAN.md do início ao fim:
- Quadro de evidências e personalidade.
- História: promessa, momento marcante, 3 ganchos → 1.
- Cada dial definido, cada um com seu motivo.
- Singularidade em relação ao estúdio: leia o
DIRECTION.md› Fingerprint dos outros filmes. Filmes feitos antes de v0.2 não têm nenhum; trate-os como house 120 BPM em Lá menor com títulos alinhados à esquerda sobre um card. - Escreva DIRECTION.md e SCRIPT.md no andamento escolhido.
Não peça ao usuário para escolher um estilo. A direção vem das evidências.
3. Uma aprovação
Mostre o resumo de 4 linhas (Sensação · Som · Visual · Momento marcante) e uma grade compacta de batidas (tempo · imagem · palavras · junção). Em seguida, pergunte, com AskUserQuestion se disponível (caso contrário, no chat):
- O plano: aprovar ou alterar algo.
- Ilustrações: "Devo desenhar ilustrações para este filme?" Sim, ilustre / Alguns acentos / Não, apenas screenshots e texto. Recomende uma com um motivo (PLAN.md §5).
- Desenhá-las é gratuito: Claude escreve SVGs.
- Somente se a sessão tiver uma ferramenta de geração de imagens conectada, adicione-a como opção e diga que pode custar dinheiro.
Não escreva nenhum código de cena antes da aprovação. Uma mudança aqui é barata.
4. Construa
- Ilustrações (se sim): escreva os SVGs em
assets/drawn/nas cores da marca e uma espessura de linha (ENGINE.md › Ilustrações desenhadas). Observe cada uma renderizada em uma folha e redesenhe qualquer coisa desajeitada. scenes/Film.swift: substitua o esqueleto completamente. Cada valor vem de DIRECTION.md e SCRIPT.md:- os tempos vão em
enum T; - clipes e junções vão em um
Reel; - telas passam pelas chamadas de enquadramento (nunca cortadas em uma caixa fixa);
- o momento marcante é redesenhado para animar exatamente como a UI real. Meça onde ele está primeiro:
bash ROOT/scripts/inspect.sh <screenshot> find <sua cor>(ourow,column,pixel) dá anéis, barras e bordas de texto exatos. - Elementos personalizados que a direção precisa vão em seus próprios arquivos
scenes/*.swift.
- os tempos vão em
- Som: a
Recipeda direção +Sections vias.compose, mais ums.cuepara cada evento de imagem, usando os sons característicos. - Verifique se compila:
bash ROOT/scripts/run.sh <film> sheet(sem tempos: o filme inteiro mais cada junção). Corrija erros de compilação (ENGINE.md › Pegadinhas).
5. Rascunho, corrija, depois mostre ao usuário
Trabalhe em rascunhos e nunca faça loops infinitos:
- Rascunho 1 é a primeira compilação completa: cenas, música e cada cue. Revise-o a partir do próprio filme (os passos abaixo); você não precisa de um arquivo de vídeo para isso. (
run.sh <film> draftrenderiza um MP4 pequeno e rápido se o usuário quiser uma prévia.) - Autoavaliação: uma passada, e cada verificação.
run.sh <film> check: cada ✗ é uma correção obrigatória. Segure a linha por mais tempo, comece-a mais cedo, corte palavras ou remova a linha. Uma linha digitada precisa de seu tempo de digitação mais seu tempo de leitura. Siga também seus conselhos ⚠ (quadro 1, ritmo), a menos que DIRECTION.md diga por que não.run.sh <film> sheet: pontue cada categoria em checklist.md e corrija qualquer coisa abaixo de 8. Olhe parastillsem tamanho real do gancho, do momento marcante e do cartão final: a UI é legível, algo colide, cada canto do quadro está fazendo algo ou deliberadamente vazio?- O que os espectadores punem (RESEARCH.md › verificação da comunidade): UI muito pequena para ler, oscilação em coisas grandes, planos de um comprimento só, música com som de stock, um momento de logotipo lento.
run.sh <film> audio, depoisbash ROOT/scripts/compare.sh <film>: se outro filme for muito semelhante, altere a receita por um motivo.- Percorra o filme inteiro:
run.sh <film> sheet $(seq 0.5 1 <duração>)(um quadro por segundo). Procure o que stills isolados escondem: uma cena que se esvazia, uma batida sem movimento, uma junção que choca, uma linha que aparece exatamente quando a cena sai.
- Rascunho 2. Corrija tudo encontrado em um lote, depois execute
checkesheetnovamente.- Se algo ainda falhar, permita no máximo mais uma passada de correção.
- Se ainda falhar depois disso, não continue: diga ao usuário o que resta e por quê.
- Mantenha um breve registro de crítica em SCRIPT.md: o que mudou e por quê.
- Renderize o arquivo real:
run.sh <film> video, cerca de 45 s para 30 s. - Mostre e pergunte (AskUserQuestion se disponível). Envie o MP4, o resumo de 4 linhas e o registro de crítica, depois faça 3–4 perguntas direcionadas sobre este corte. Cada uma precisa de uma opção recomendada, e "Outro" permite que o usuário diga qualquer coisa:
- Ritmo: parece certo / mais lento, menos linhas / mais rápido, mais impacto.
- Som: manter / mais energia / mais calmo / instrumentos diferentes.
- Gancho: manter, ou o mais forte dos outros dois candidatos a gancho do modo plano, nomeado.
- Final: manter / um final seguro para lançamento (por exemplo, sem selo de Download antes do app estar ao vivo) / adicionar o preço.
- Revise uma vez por rodada de respostas, executando novamente
check,audioecompare, depois mostre o novo corte. Após duas rodadas do usuário, ofereça parar ou continuar; o usuário decide.
6. Armazene selos (apenas se o produto estiver ao vivo)
- App Store ao vivo e o usuário quer um selo: peça permissão para baixar o selo oficial da Apple (cerca de 11 KB, preto, SVG em inglês; URL em rules.md) para
assets/.- Desenhe-o com
drawAppStoreBadge, parado e nunca animado; a ênfase vem deglowRing. - Se o usuário insistir em animá-lo, explique a regra da Apple uma vez. Se ele ainda quiser, faça disso uma variante separada e claramente nomeada.
- Desenhe-o com
- Google Play: seu selo apenas se o app estiver ao vivo lá e o usuário aprovar o download. Caso contrário, no máximo uma linha de texto simples, e apenas se for verdade.
7. Entregue
A cada corte que você mostrar, inclua:
- o resumo em algumas linhas;
- o que a autoavaliação corrigiu;
- o resultado da comparação e o veredito de
check; - as afirmações a verificar antes de postar;
- como alterá-lo: edite SCRIPT.md ou DIRECTION.md, ou apenas diga.
Depois que o usuário estiver satisfeito, ofereça as próximas coisas úteis:
- um corte de 15 s, ou outro formato (1:1, 16:9);
- variantes de gancho para um teste A/B: o mesmo filme aberto com os outros dois candidatos a gancho do modo plano;
- um final seguro para lançamento (sem "Download" antes do app estar ao vivo);
- uma versão apenas com efeitos (
run.sh <film> video effects), para postar com um som de plataforma ou uma faixa licenciada.