O que script faz?
O Escritor escreve o que o usuário diz no vídeo. Objetivo: o usuário lê uma vez e grava. Cada frase carrega ou prova a promessa do título e da thumbnail.
Antes de escrever
- O título e o texto da miniatura estão aprovados (
brief/TITLE-vNNN.md). Sem título, sem roteiro. - A prova está aprovada (
brief/PROOF-vNNN.md). Nunca invente um número, uma experiência ou uma citação. Se algo estiver faltando, pergunte através do chat (crewcut say) antes de escrever; o roteiro não tem lacunas ou marcadores de posição. - Leia
voice.md(como o usuário fala, palavras a usar e a evitar),brand/rules/script.mde a duração emedit-style.json(length_minutes) com a taxa de fala emchannel.json(script.words_per_minute). - Leia os encerramentos dos três últimos roteiros, para que este veredito assuma uma nova forma.
Estrutura
Duas formas. Use o formulário de teste para uma ferramenta ou uma afirmação; use o formulário de história quando
algo aconteceu (detalhes em references/forms.md).
- Abertura, de 2 a 6 frases. Os primeiros segundos carregam a promessa e seu número: a frase 1 nomeia a ferramenta ou tópico e sua afirmação. Sem saudação, sem pergunta, sem "neste vídeo". Os primeiros 30 segundos confirmam o clique: o espectador vê que recebeu o vídeo que o título e a miniatura prometeram. No máximo um loop em aberto, resolvido no final.
- O problema, em um caso que o espectador conhece. Explique uma ferramenta desconhecida na primeira vez que aparecer.
- O que faz, em imagens, apenas o que o espectador ainda não sabe.
- O próprio teste, com números reais, arredondados como as pessoas falam. Apenas testes do que a ferramenta foi feita para fazer.
- Uma linha de inscrição, logo após o primeiro resultado forte: o que o espectador ganha com o canal. Se nenhum fornecedor paga pelos testes, diga isso nessa linha. Nunca no início, nunca como um apelo no final.
- Pequenas histórias com apostas crescentes. Cada bloco entre a abertura e o veredito tem um objetivo, um obstáculo e uma solução; de bloco para bloco as apostas aumentam (mais dados, mais dinheiro, um teste mais difícil). O teste mais forte vem por último, antes do veredito; a abertura pode anunciá-lo, mas não revelá-lo.
- O lado crítico. O número do fornecedor contra a própria medição ou uma independente; os limites. Se a ferramenta não cumpre sua promessa, diga, e o título volta para a etapa do título.
- O veredito, em sua própria forma a cada vez: uma tarefa para o espectador, o único número que fica, o que significa para o próprio trabalho do usuário, um retorno à imagem da abertura. Não é uma pergunta fixa de encerramento.
- O final. Se
channel.jsontem uma oferta ou menção obrigatória (script.end_mentions), ela vem nas últimas frases, nas palavras do usuário. A última frase é oclosing_linedo canal quando houver uma.
Vídeos de comparação: no máximo dois blocos com a mesma construção em sequência; o terceiro muda de forma. Um novo gancho na metade. Cada afirmação uma vez. Custo e tempo de todos os candidatos uma vez, juntos na tela, não no final de cada bloco.
Palavras
- As palavras do usuário de
voice.md; nunca as palavras em sua lista de evitar. - Frases curtas: mediana de cerca de 10 a 12 palavras, nunca mais que
script.sentence_max_words. - No máximo três nomes de produtos em uma frase; listas mais longas vão para a tela.
- Fora: conhecimento básico que o público tem, detalhes que ninguém se importa (contagens de testes, interruptores internos), nomes de arquivos, comandos, tópicos secundários, pessoas privadas, por que um exemplo foi escolhido, custos que não fazem parte da promessa.
- Sem tom de anúncio ou vendas: diga o que foi testado, não prometa nada ao espectador. Sem grandes "não isso, mas aquilo" na abertura.
- Negócios se mostram através de exemplos, não ao abordar o negócio do espectador.
Formato de teleprompter
O usuário lê de um telefone ao lado da câmera.
- Apenas texto falado acima de uma linha
---. Notas para a edição (cenas, clipes, de onde vem cada número) vão abaixo dela. - Um parágrafo é uma respiração: 1 a
script.paragraph_max_sentencesfrases. Uma linha vazia é uma pausa curta. - Três linhas vazias separam partes: ali a edição pode cortar, ali o teleprompter vira a página, ali um clipe pode rodar.
- Sem colchetes, notas de palco, títulos, capítulos, carimbos de tempo ou linha de título. Travessões apenas se o pacote os permitir.
- Marque a palavra ou duas palavras-chave de um parágrafo em negrito. O modo de pontos do teleprompter as mostra em vez do texto completo, para um usuário que queira falar livremente.
Passos
- Preencha a estrutura com os números comprovados.
- Corte: cada frase carrega ou prova a promessa.
- Coloque na voz do usuário. Leia cada frase mentalmente: o usuário diria isso para a câmera?
- Escreva o rascunho em
work/script-draft-vNNN.mdcom o próximo número livre; nunca sobrescreva uma versão. - Passagem de humanização (veja abaixo). Escreva o resultado em
brief/SCRIPT-vNNN.md(mesmo número), depois grave-o:crewcut humanize record --draft work/script-draft-vNNN.md --final brief/SCRIPT-vNNN.md --why "<os padrões que se aplicaram>". - Verifique até 0 erros:
python3 skills/script/scripts/script_check.py brief/SCRIPT-vNNN.md --title "<título>" --name "<ferramenta>" --proof brief/PROOF-vNNN.md. Leia cada aviso e dica; uma dica que você mantém ganha uma frase de razão abaixo de---. Se você alterar o roteiro para passar na verificação, grave a passagem novamente: o cartão precisa do registro do arquivo exato. - Cartão:
crewcut card propose --episode <id> --step script --kind script --title "Roteiro, versão N" --file brief/SCRIPT-vNNN.md --body "<palavras>, cerca de <min> min, verificação: 0 erros", depoiscrewcut card wait. O cartão mostra "Humanizado" com o que mudou; sem o registro ele é recusado e diz o que executar. - Após o sim:
crewcut prompter <id>imprime o link do telefone e um código QR. Informe o usuário em uma mensagem: o link, quantas partes, aproximadamente quanto tempo. O teleprompter mostra apenas o texto acima de---.
Passagem de humanização
Todo rascunho de roteiro passa pelo Humanizer (blader/humanizer, MIT)
antes de o usuário vê-lo: tanto vídeos longos quanto Curtos. O Crewcut baixa sua versão mais recente na inicialização;
no Claude Code é a skill humanizer:humanizer (execute como qualquer skill), com Codex seu texto está no seu prompt.
crewcut skills status mostra a versão.
- Modo "Incorporado", com a voz do usuário. Leia primeiro todos os arquivos em
brand/voice/: as palavras faladas reais do usuário de seus vídeos. Forneça-os ao Humanizer como amostra de voz. Sem amostras: modo simples; o cartão informa isso. - O que procurar mais: contrastes "não X, mas Y"; linhas de encerramento que não acrescentam nada novo; ditados que soam profundos; uma preparação encenada antes do ponto ("a questão é"); listas de três; significado inflado e linguagem publicitária.
- O que permanece: as próprias palavras e expressões do usuário (aquelas em
brand/voice/evoice.md) mesmo quando o Humanizer as suavizaria; cada número, nome, afirmação e a promessa do título. A passagem muda como soa, nunca o que diz. - O que está fora do escopo: fazer o texto passar por detectores de IA. O Humanizer edita para pessoas, e nós também.
O que a verificação não pode ver
Se um exemplo se torna muito amplo, se uma parte sai do fio condutor, se um teste se encaixa na promessa, se a voz soa como o usuário. Isso é trabalho de leitura nos passos 2 e 3.
Planejado
- Folha de sugestões e duas tomadas por parte (primeira livre de uma folha de sugestões, depois do roteiro; a edição
pega a melhor tomada): formato em
references/forms.md; o verificador e a mixagem de tomadas (zettel.pyno estúdio) ainda não foram portados. - Roteiro contra gravação: comparar o roteiro aprovado com a transcrição para aprender as palavras reais do usuário (essas transcrições podem se tornar novas amostras de voz).
- Uma lista de verificação de frases por idioma (palavras de preenchimento, frases de venda) como dados em
voice.md.
Fontes
-
Humanizer por blader, https://github.com/blader/humanizer (MIT), construído sobre os "Sinais de escrita de IA" da Wikipédia. Usado como uma skill, baixado na inicialização; seu texto não faz parte deste repositório.
-
Vexian no podcast de Grant Owen, "The Crazy Genius Who Solved The Youtube Algorithm": https://www.youtube.com/watch?v=41HMFGbENj4. Extraído: o gancho são os primeiros segundos, cada bloco é uma pequena história, o teste mais forte vem por último, a linha de inscrição com independência, a oferta tarde no vídeo.
-
Manual de produção do MrBeast (público desde 2024), resumo: https://simonwillison.net/2024/Sep/15/how-to-succeed-in-mrbeast-production/ Extraído: o primeiro minuto entrega o que o título e a miniatura prometeram.
-
Contação de histórias em vídeos curtos de fundadores: Farza (https://www.youtube.com/@farzatv), Chris Raroque (https://www.youtube.com/@raroque), Roy Lee (https://www.youtube.com/@im_roy_lee), Riley Brown (https://www.youtube.com/@rileybrownai), Varun Mayya (https://www.youtube.com/@VarunMayya), Codie Sanchez (https://www.youtube.com/@CodieSanchezCT). Extraído: primeira pessoa, a virada, números reais irregulares.