Inicialização do Studio (etapa 02 do curso)
Crie um projeto de filme que pode renderizar, ouvir e olhar para seus próprios quadros. O aplicativo de bate-papo pode escrever uma animação; apenas um agente com um shell pode fechar a renderização, olhar, corrigir o loop. Esse loop é a diferença entre uma primeira tentativa "medíocre" e um filme digno de ser postado.
Argumentos da solicitação (podem estar vazios), mostrados uma vez:
1. Escolha o diretório e as configurações
- Diretório: o primeiro argumento; senão
.quando o diretório de trabalho estiver vazio; senão pergunte (padrão./<slug-do-titulo>). Nunca crie o projeto dentro do diretório do plugin. - Configurações da solicitação: título, duração, formatos, fps, bpm, loop, URL da marca. Deixe o restante
nos padrões do modelo (
studio.json: 12 s, 60 fps, 4 subquadros, 120 BPM, primário9x16).
2. Estruturar
node "${CLAUDE_SKILL_DIR}/scripts/init.mjs" <dir> --title "<Title>" [--duration S] [--fps N] [--bpm N] [--formats a,b] [--loop] [--brand-url URL] [--install] [--json]
| Bandeira | Efeito |
|---|---|
<dir> | alvo; criado se ausente |
--title T | título no studio.json e slug do arquivo de entrega |
--duration S, --fps N, --bpm N | temporização |
--formats a,b | subconjunto de 9x16, 1x1, 16x9, 4x5 (ou all); primaryFormat permanece a menos que não esteja listado |
--loop | filme de loop contínuo (interface se transforma) |
--brand-url URL | armazena a URL do produto em brand.url. user:password@ e parâmetros com aparência de segredo (query, ;matrix, fragmento: token, key, secret, password, auth, sig, session, code ...) são removidos antes de qualquer gravação; stderr nomeia o que foi removido e --json lista em redacted. Ainda assim, passe uma URL pública simples: um segredo que é um segmento de caminho simples (/reset/<token>) não pode ser reconhecido. Uma URL simples é armazenada exatamente como digitada |
--install | executa npm install no novo projeto (lida com npm.cmd no Windows) |
--force | atualiza um projeto antigo para o modelo atual (veja a tabela abaixo) |
--json | uma linha de resultado JSON em stdout |
Um diretório existente não vazio é mesclado: apenas os arquivos ausentes são adicionados e os arquivos ignorados são listados. Relate a lista ignorada ao usuário; nunca exclua os arquivos deles.
--force em um projeto existente (verificado em relação a init.mjs):
| Caminho | Com --force |
|---|---|
studio.json, film/**, docs/**, assets/fonts/fonts.json | mantidos e listados como kept; um ausente ainda é criado. Bandeiras como --bpm ainda corrigem studio.json |
package.json | mesclado, nunca substituído: define type: module, adiciona private, engines e todo script ou dependência do modelo que o projeto não possui. Um script do modelo cujo comando difere é redefinido para o comando do modelo (init imprime cada um como was ..., now ... e os retorna em packageReset). As versões de dependência nunca são alteradas, dependências do modelo incluídas: um intervalo existente permanece, mais novo, mais antigo ou fixo. Nome, versão, outros scripts e outros campos permanecem |
.gitignore | mesclado: linhas ausentes do modelo são anexadas abaixo de # motion-studio, nada é removido |
todo o resto (CLAUDE.md, lib/**, tools/**, prompts/**, index.html, .env.example, fontes incluídas) | sobrescrito e listado como overwritten. Edições locais nesses arquivos são perdidas: commit ou copie-os primeiro |
| seus próprios arquivos extras | intactos |
Sem --force, package.json e .gitignore são mesclados da mesma forma, exceto que um script diferente
mantém seu comando. Init lista todo script e versão de dependência que difere do modelo em
kept your package.json values, which differ from the template (packageKept no resultado --json): esses npm run
nomes executam SEU comando, e --force redefine scripts do modelo (nunca versões de dependência). Uma seção scripts,
devDependencies ou optionalDependencies que não é um objeto é deixada intacta com um aviso. Como docs/** é mantido, um documento de modelo mais recente nunca atinge um projeto existente: compare com o template/docs/ do plugin manualmente após uma atualização.
3. Instalar, navegador, doctor
- Sem
--install, executenpm installdentro do projeto.playwrighté a única dependência obrigatória;ffmpeg-staticé opcional e pode falhar ao baixar atrás de um proxy. - Navegador (
npm run setup:browseré o mesmo comando que a linhanpx):- Windows: execute
npx playwright install chromium-headless-shell(cerca de 115 MB de download, 270 MB no disco).studio.jsonbrowser: "auto"inicia apenas esse shell headless incluído, nunca o Chrome ou Edge instalado. Motivo: um Chrome ou Edge instalado iniciado com um perfil novo (a cada execução da ferramenta) faz o Chrome testar a conta do Windows para uma senha em branco, o que conta como uma falha de login. O laptop medido bloqueia a conta após 10 falhas de login em 10 minutos e registrou 464 em 24 h. Não alterebrowserparachromeoumsedge, e não definaMOTION_CHROME_PATHpara umchrome.exeoumsedge.exe, a menos que o usuário peça e aceite o risco: ele imprime um aviso por inicialização e a 4ª inicialização em 10 minutos é recusada, 3 passam (o protetor de inicialização). O shell não é assinado, portanto um antivírus em tempo real pode tornar cada execução da ferramenta 15 a 25 s mais lenta (medido): informe o usuário uma vez; uma exclusão de antivírus para%LOCALAPPDATA%\ms-playwrighté decisão deles ou de TI. - macOS e Linux:
autotenta o Chrome instalado, depois Edge, depois o navegador incluído, sem aviso. Se nenhum estiver instalado, executenpx playwright install chromium-headless-shell(Linux:npx playwright install --with-deps chromium-headless-shell), ou definaMOTION_CHROME_PATHpara um executável da família Chromium.
- Windows: execute
npm run doctor. Corrija cada linha FAIL antes de entregar, e no Windows uma linha WARN de navegador também (um Chrome ou Edge instalado foi escolhido: limpe-o e instale o shell headless); correções por SO estão em references/troubleshooting.md. Python com librosa é opcional (o mecanismo de batida JS cobre). Node 22+ é necessário apenas para ferramentas da rota B.- Prove:
npm run stills, depois abraout/review/9x16/contact.png(um filme longo é paginado:contact.pngé a página 1, depoiscontact-2.png..., nenhuma página com mais de 1800 px de altura; abra todas as páginas) e olhe. A demo de 12 s enviada deve mostrar um quadro composto em 0 s e uma mudança em cada tempo forte.npm run previewabre a pré-visualização ao vivo (Space pausa/play, setas avançam quadros, F cicla formatos, G guias de área segura).
4. Explique o projeto ao usuário
Resuma em algumas linhas, depois aponte para as referências:
- Layout e quem edita o quê: references/project-layout.md
- Todos os comandos: references/commands.md
- Todas as assinaturas e padrões
lib/:docs/API.mdno novo projeto (a referência completa édocs/ARCHITECTURE.mdno repositório do plugin) - As regras da casa residem no
CLAUDE.mddo projeto, que o Claude Code lê a cada execução lá.
Se init imprimiu uma linha de estrela ★ (starHint no resultado --json; aparece uma vez por máquina, no primeiro novo projeto),
termine seu resumo com essa única linha como escrita. Nunca dê estrela no repositório ou execute gh para o usuário.
| Comando | Faz |
|---|---|
npm run preview | pré-visualização ao vivo no navegador |
npm run stills | um still por batida como folha de contato |
npm run critique | contato, tira, teste de telefone, métricas, bloco de revisão |
npm run gate | portão de crítica: 3 rodadas, todos os eixos >= 8, sem P0 |
npm run render:final | todos os formatos, qualidade final (portão aplicado) |
npm run sfx / npm run mix | sintetizar SFX de cue / mixar para -14 LUFS e multiplexar |
npm run deliver | verificações de entrega e pacote out/deliver/ |
npm run build | partitura se ausente, sfx, renderização final, mix, entrega |
5. Esforço e rotas
| Trabalho | Esforço | Definir com |
|---|---|---|
| pequenas correções, re-renderizações | médio | /effort medium |
| um novo filme | xhigh | /effort xhigh (a habilidade motion-reel define para você) |
| primeiros 3 segundos emblemáticos de um lançamento | max | /effort max |
/model também oferece a escolha de esforço ao selecionar Opus 5.5. A Rota A (este mecanismo) é o padrão.
Use Remotion ou HyperFrames apenas quando o usuário nomear um; /motion-studio:seek-engine tem o
handoff, incluindo o portão de licença Remotion.
6. Chaves
Copie .env.example para .env apenas quando uma chave for necessária (voz: ELEVENLABS_API_KEY; rota C
imagens/vídeo: FAL_KEY). Diga ao usuário para colar o valor em .env ele mesmo. Em prompts e
logs, refira-se apenas ao nome da variável. .env já está no .gitignore do projeto.
7. Companheiros opcionais
Mencione estes apenas quando relevante. Comandos de instalação e observações: references/companions.md.
| Companheiro | Uso para | Nota |
|---|---|---|
| claude-animation (buildwithhanif) | desenho à mão, pincel, aparência de storybook | MIT; renderizador de canvas Node separado |
| HyperFrames (heygen-com) | composições HTML + GSAP | Apache-2.0; Node 22+ |
| Remotion | séries e modelos React | licença corporativa para organizações com fins lucrativos com mais de 3 funcionários |
Próximo: teste o mecanismo com /motion-studio:showreel, ou faça um filme real com
/motion-studio:motion-reel.