primocode 10.15.2 → 10.17.0

package/editor/references/modelos.md

@@ -0,0 +1,494 @@
+# Modelos de vídeo
+
+Cada modelo é um ponto de partida. Escolha o mais parecido com o pedido, diga à pessoa qual escolheu e ajuste pelo
+briefing. Os campos entre colchetes são preenchidos com os dados dela.
+
+Todo modelo segue o mesmo caminho: corte aprovado, plano em blocos, amostra no estúdio, vídeo inteiro no estúdio,
+som e trilha, render só no fim, conferência do arquivo exportado e entrega com nota curta. A amostra mostra o
+momento que prova o padrão (quase sempre: a pessoa, a inserção e a volta à pessoa). Autorização em camadas: se a
+pessoa pediu para aprovar a amostra, espere; se autorizou tudo, a amostra é teste interno.
+
+Vale para todos: só o que existe nos arquivos. Nada de depoimento, número, clique, tela de sucesso, reação ou
+oferta inventados. Faltou material, a lacuna aparece e você pede.
+
+Nomes que existem no projeto (`modelo-projeto/LEIA.md`), para não pedir o que o build não tem:
+- **Legenda:** `legenda.estilo` `"padrao"` (Montserrat 900, caixa alta, branca com contorno) ou `"discreta"`
+  (mais leve, para VSL, aula e conversa), até 3 palavras por vez (`max_palavras` 3). Legenda escrita à mão, frase se
+  escrevendo, etiqueta de papel: é cena própria (`compositions/cenas/LEIA.md`), com a legenda do projeto
+  escondida naquele trecho. Impacto, Manchete e Papelaria são nomes do motor antigo (`estilos-prontos.md`).
+- **Gancho escrito:** peça `rotulo` do catálogo ou cena própria.
+- **Letra grande com ordem de leitura:** peça `lettering` do catálogo (principal, apoio e chamada; modelo 13).
+- **Esquema que cresce, objeto que muda de estado, antes e depois desenhado:** as cenas do kit 2D
+  (`k2d_esquema`, `k2d_arquivo`, `k2d_conversa`, `k2d_antes_depois`), adaptadas pelo `PARAM`
+  (`references/animacao.md`, "Kit 2D").
+- **Punch-in e zoom na tela gravada:** `zooms` no bloco `tela_cheia` ou `prova` (sem `caixa`, punch-in no
+  rosto; com `caixa`, o zoom anda até ela na palavra): `references/enquadramento.md`, "Zoom na palavra".
+- **Borrão:** `borrar` no bloco, cada caixa com o seu `de` e `ate`, queimado na cópia do corte do projeto
+  (acompanha o zoom). Depois, a conferência de dado pessoal no arquivo exportado (`references/revisao.md`).
+- **Fim com tempo de leitura:** quando a última palavra é a conclusão e o texto precisa ficar na tela, use
+  `segura_fim` no `projeto.json` (segundos depois da última palavra). O corte tira a sobra depois da fala; o
+  tempo de leitura vem daí, não de um trecho sem fala no corte.
+- **Formato:** fonte gravada em pé vira close da cabeça num 16:9 (o corte guarda só um terço da altura).
+  Com fonte em pé, prefira 9:16; se o 16:9 é obrigatório, a pessoa entra contida (o quadro inteiro numa
+  caixa, como cena própria), e diga isso à pessoa.
+
+| # | modelo | quando |
+|---|---|---|
+| 1 | Anúncio com prova na tela | a pessoa fala e mostra a coisa funcionando |
+| 2 | Anúncio papelaria | cara de feito à mão, fotos reais da vida dela |
+| 3 | Reel "editado ao vivo" | um processo acontecendo, cara de sistema trabalhando |
+| 4 | Promo horizontal com objetos na mão | apresentação 16:9 com a pessoa gesticulando |
+| 5 | Aula com tela e câmera | tutorial de ferramenta, onde clicar |
+| 6 | VSL com momentos animados | vídeo de vendas longo |
+| 7 | Resposta a uma pergunta | pergunta de cliente ou aluno num cartão, resposta em tela cheia |
+| 8 | Produto a partir de fotos | apresentar um produto com fotos e vídeos reais |
+| 9 | Aula com diagrama que cresce | conceito explicado com um esquema que vai ganhando partes |
+| 10 | Corte de podcast ou conversa | um trecho de conversa que se sustenta sozinho |
+| 11 | Composição em planos | palavra atrás do corpo e objeto à frente, nos pontos fortes |
+| 12 | Explicação espacial em 3D | quando volume, ângulo ou o que tampa o quê explicam a ideia |
+| 13 | Fala curta com destaques tipográficos | um raciocínio curto em que 2 a 4 expressões ditas ganham letra grande |
+| | Lote de ganchos e outras versões | `references/variacoes.md` |
+
+---
+
+## 1. Anúncio com prova na tela
+
+**Pra quê:** anúncio em que a pessoa fala e mostra a coisa funcionando (tela do app, painel, produto, resultado de processo).
+**Formato:** 9:16, 1080x1920, 20 a 45 s.
+**Precisa ter:** o vídeo falado; gravação de tela ou fotos da prova. **Ajuda ter:** logo do produto dela, um segundo arquivo para comparar.
+
+**Blocos típicos**
+1. Gancho (0 a 3 s): rosto + gancho escrito em cima.
+2. Problema (3 a 10 s): rosto com punch-in na ênfase.
+3. Prova (10 a 25 s): a tela ocupa tudo, rótulo curto em cima ("ISSO AQUI É O APP"); a pessoa sai de cena ou fica num quadrinho breve.
+4. Como funciona (25 a 35 s): moldura com a pessoa pequena e a prova grande; lista que marca.
+5. Chamada (últimos 3 a 5 s): rosto + cartão final com a ação que ela falou.
+
+**Estilo de partida:** legenda `padrao`, gancho escrito como `rotulo` (ou cena própria), uma cor de destaque, um som por animação, trilha 22 a 24 dB abaixo da voz.
+**Cuidado:** comparação só se existirem os dois arquivos, no mesmo instante, escala e velocidade, com rótulos literais (dois vídeos: bloco `comparar`; algo que se desenha: cena `k2d_antes_depois`). Dado privado de cliente vai borrado.
+
+**Pedido pronto**
+```
+Edita o vídeo da pasta [PASTA DO VÍDEO] como anúncio com prova na tela, 9:16, de 20 a 45 segundos.
+O produto é [PRODUTO] e o clique vai pra [DESTINO DO CLIQUE].
+As provas estão na pasta [PASTA DAS PROVAS]: use cada uma em tela cheia no momento em que eu falo dela, com um rótulo curto em cima.
+Quando eu voltar a falar olhando pra câmera, eu fico em tela cheia ou numa moldura.
+Faz primeiro a amostra de um trecho com prova e moldura antes do vídeo inteiro.
+```
+
+**Perguntas de revisão**
+- A prova mostra exatamente o que a fala afirma?
+- O detalhe da prova dá para ler no celular?
+- A pessoa está centralizada na tela cheia e na moldura?
+- Se tem comparação, os dois lados são equivalentes?
+- A chamada na tela é a mesma que ela falou?
+
+---
+
+## 2. Anúncio papelaria
+
+**Pra quê:** anúncio com cara de feito à mão, pra público feminino, com fotos reais da vida da pessoa.
+**Formato:** 9:16, 20 a 60 s.
+**Precisa ter:** o vídeo falado. **Ajuda ter:** fotos reais (antes, rotina, conquistas pessoais).
+
+**Blocos típicos**
+1. Gancho: rótulo em cima da cabeça, escrito à mão.
+2. História: fotos reais entrando como polaroides com som de câmera.
+3. Explicação: moldura com papel quadriculado, a pessoa num quadro, anotações aparecendo (lista com check, marca-texto).
+4. Notificações ou mensagens reais, se ela mandou os prints.
+5. Chamada: cartão final com botão.
+
+**Estilo de partida:** frase escrita à mão (Caveat) como cena própria nos trechos fortes e legenda `discreta` no resto, cores pastel com um destaque forte, fonte redonda + fonte manuscrita, estilo `papelaria` do projeto (papel quadriculado atrás da moldura). Lettering no estilo aprovado do André (`references/lettering.md`).
+**Som:** a biblioteca não tem papel, lápis nem fita. Use `pop` (etiqueta e papel entrando), `camera` (polaroide), `tique` (check da lista) e `risco` (item riscado), e diga à pessoa que não há som de papel. Se ela quiser um de verdade: importar um som com licença (`helpers/efeitos.py importar`) ou gerar (`helpers/gen_sfx.py`, pago, só com o ok dela).
+**Cuidado:** só fotos dela. Foto de banco de imagem nunca entra como se fosse da vida dela.
+
+**Pedido pronto**
+```
+Edita o vídeo da pasta [PASTA DO VÍDEO] no estilo papelaria, 9:16.
+Tom feminino e leve, cores [CORES OU "decide você"].
+Quando eu falo de [MOMENTO DA HISTÓRIA], usa as fotos da pasta [PASTA DAS FOTOS] como polaroides.
+No trecho em que eu explico, me coloca numa moldura com papel quadriculado e anotações aparecendo.
+Amostra primeiro.
+```
+
+**Perguntas de revisão**
+- Cada foto aparece na frase que fala dela?
+- As anotações resumem a fala sem repetir a legenda?
+- O rosto fica livre quando o rótulo está em cima da cabeça?
+- Nada escrito que ela não disse?
+
+---
+
+## 3. Reel "editado ao vivo"
+
+**Pra quê:** mostrar um processo acontecendo (edição, ferramenta, análise), com cara de sistema trabalhando.
+**Formato:** 9:16, 45 a 60 s.
+**Precisa ter:** o vídeo falado com a pessoa explicando o processo.
+
+**Blocos típicos**
+1. Gancho: frase grande em 2 ou 3 linhas entrando palavra a palavra; legenda escondida.
+2. Revelação: caixas de detecção no rosto com rótulos curtos, virada ("quem fez foi...").
+3. Seções numeradas: uma pílula no topo com "EDITANDO AO VIVO" e o nome da etapa (01, 02, 03...); cada etapa mostra o dado real daquela parte (transcrição correndo, cortes marcados, legenda sincronizada, zoom).
+4. Fechamento: carimbo "CONCLUÍDO" e chamada pra comentar uma palavra.
+
+**Estilo de partida:** fundo escuro, um acento forte, rótulos em fonte mono caixa alta, legenda de 1 a 3 palavras, sons de interface (clique, teclado, ding), trilha baixa entrando depois do gancho.
+**Cuidado:** todo número na tela vem de dado real do próprio vídeo (duração antes e depois, quantidade de cortes).
+
+**Pedido pronto**
+```
+Edita o vídeo da pasta [PASTA DO VÍDEO] no formato "editado ao vivo", 9:16.
+No topo, uma pílula "EDITANDO AO VIVO" com o nome de cada etapa que eu cito: [ETAPAS, ex.: transcrição, cortes, legenda, zoom].
+Em cada etapa, mostra o dado real deste vídeo (números de verdade, nada inventado).
+Fecha com um carimbo de concluído e a chamada: comenta [PALAVRA].
+Amostra primeiro, de um trecho com duas etapas.
+```
+
+**Perguntas de revisão**
+- Cada número na tela foi medido neste vídeo?
+- A etapa na pílula muda na palavra em que ela cita a etapa?
+- A transformação de uma etapa para a outra é contínua, sem cartão sumindo e aparecendo?
+
+---
+
+## 4. Promo horizontal com objetos na mão
+
+**Pra quê:** vídeo 16:9 de apresentação (produto, curso, novidade), com a pessoa gesticulando e coisas aparecendo nas mãos.
+**Formato:** 16:9, 1920x1080, 60 a 120 s.
+**Precisa ter:** o vídeo falado em horizontal. **Ajuda ter:** logos que ela pode usar, prints, B-roll.
+
+**Blocos típicos**
+1. Abertura: rosto + título grande do lado livre da tela.
+2. Blocos numerados (01/08, 02/08...): a pessoa numa moldura de um lado, painel de explicação do outro.
+3. Objetos presos à mão: logo ou cartão que acompanha a mão quando ela arrasta.
+4. Punch-ins nas ênfases (1 ou 2 por bloco).
+5. Chamada e cartão final.
+
+**Estilo de partida:** títulos grandes com ponto final colorido, kicker pequeno em caixa alta, vidro fosco nos painéis, fora da moldura o vídeo desfocado, trilha entrando quando a fala cita "trilha" ou depois do gancho.
+**Como montar:** o vídeo desfocado fora da moldura é `"fundo": "desfocado"` no bloco `moldura`; o painel de vidro fosco ao lado é peça ou cena própria. Punch-in nas ênfases: `zooms` no bloco de tela cheia (`{"em": "palavra", "escala": 1.3, "ate": "outra"}`), um ou dois por bloco.
+**Cuidado:** a mão às vezes sai do quadro; prenda o objeto acima da palma. Só logos que a pessoa pode usar. Receita pensada para gravação deitada: com fonte em pé, faça 9:16 ou a pessoa contida (veja "Formato" no começo).
+
+**Pedido pronto**
+```
+Edita o vídeo da pasta [PASTA DO VÍDEO] em 16:9, formato original.
+Quero dinâmico: zooms nas ênfases, blocos numerados, e quando eu falo de [PRODUTOS OU APPS] a logo aparece e acompanha a minha mão.
+Logos que eu posso usar estão em [PASTA DAS LOGOS].
+Trilha baixinha entrando depois do gancho. Amostra primeiro.
+```
+
+**Perguntas de revisão**
+- O objeto acompanha a mão sem escorregar nem tremer?
+- As mãos e o gesto mais largo cabem no quadro da moldura?
+- Cada painel sai antes do bloco seguinte?
+
+---
+
+## 5. Aula com tela e câmera
+
+**Pra quê:** aula ou tutorial de ferramenta, em que o aluno precisa ver onde clicar.
+**Formato:** 16:9, 1920x1080 (vertical só se a tela continuar legível); a duração da tarefa, dividida em partes se não couber.
+**Precisa ter:** a gravação de tela e o áudio da explicação. **Ajuda ter:** a câmera da pessoa, o roteiro de passos.
+
+**Blocos típicos**
+1. Abertura curta: a pessoa em tela cheia, o objetivo mostrado na tela real.
+2. Passos: primeiro a tela inteira para situar, depois o zoom no botão; rótulo do passo ("PASSO 2 · COLAR A MENSAGEM"); um realce por vez, só onde houve clique, escolha ou digitação de verdade.
+3. Resposta da interface: uma pausa no que a tela respondeu, e volta ao contexto.
+4. Esperas sem ação (instalação, render): saem ou são aceleradas com um contador de tempo real no canto.
+5. Fechamento: a conclusão real na tela, a pessoa em tela cheia, próxima aula.
+
+**Estilo de partida:** limpo, uma cor, poucos sons (clique quando destaca algo), trilha bem baixa ou nenhuma, legenda `discreta` ou nenhuma.
+**Som: aqui a receita vence a regra geral.** A regra "cada animação tem o seu som" e a trilha 22 a 24 dB abaixo da voz são de anúncio. Em aula: um `clique` só onde houve clique, escolha ou digitação de verdade (realce e zoom sem som, ou um `whoosh` baixo no zoom se ajudar), e trilha 25 a 26 dB abaixo da voz (`mixar_trilha.py --abaixo-da-voz 26`; com 28 ou mais ela some no celular, e aí é melhor nenhuma) ou nenhuma. Diga isso à pessoa na amostra.
+**Como montar:** "tela inteira, depois o zoom no botão" é `zooms` com `caixa` no bloco (o zoom anda até o botão na palavra e volta no `ate`). Dado na tela: `borrar` com uma caixa por coisa, cada uma com o seu `de` e `ate` (menu que abre, linha que muda de lugar); o borrão é queimado no corte, então acompanha o zoom. Tela e câmera juntas numa gravação do OBS (a câmera numa janelinha): o rosto medido é o da câmera, e o punch-in sem `caixa` vai nele.
+**Cuidado:** deixe respiro nas explicações (aula não é anúncio). Nunca acelere uma ação que o aluno precisa acompanhar. Não desenhe um segundo cursor. Esconda notificações, senhas, chaves e dados privados, e confira no arquivo exportado com o `conferir_dados.py` (`references/revisao.md`, "Dado pessoal no arquivo exportado"): um quadro sem borrão já mostra o dado. Se a pasta do projeto vai para alguém, o corte dentro dela ainda tem o dado: veja a mesma seção. Confira se o áudio e a tela são do mesmo procedimento; faltou uma ação essencial na gravação, peça.
+
+**Pedido pronto**
+```
+Edita a aula da pasta [PASTA DA AULA] em 16:9.
+Tira os erros e as pausas longas, mas mantém o ritmo de aula.
+Nos trechos de tela, mostra a tela inteira primeiro e depois dá zoom onde eu clico, com o nome de cada passo.
+Esperas sem nada acontecendo podem sair. Esconde qualquer senha ou dado pessoal. Amostra primeiro com um passo.
+```
+
+**Perguntas de revisão**
+- O aluno acha o botão antes de o zoom chegar nele?
+- O que se vê na tela é o que está sendo dito?
+- Os textos da interface se leem?
+- Os controles que o aluno precisa ver estão livres?
+- Nenhum dado privado aparece (o `conferir_dados.py` saiu com 0 achado no arquivo exportado), e o resultado final real aparece?
+
+---
+
+## 6. VSL com momentos animados
+
+**Pra quê:** vídeo de vendas longo, em que só os momentos fortes ganham animação.
+**Formato:** 9:16 ou 16:9, 5 a 20 min (horizontal para página de venda), sem esticar nem acelerar a fala.
+**Precisa ter:** a gravação (pode vir em vários arquivos). **Ajuda ter:** o roteiro (só para conferir termos), exemplos reais do produto.
+
+**Blocos típicos**
+1. Corte em blocos do roteiro, preservando frases inteiras nas retomadas.
+2. A pessoa na tela inteira como fio condutor.
+3. Momentos fortes com animação: listas, passos, garantia (selo, carimbo), a virada da história, diagrama simples para dar contexto.
+4. Os exemplos reais do produto ganham a tela na frase que fala deles, separados dos trechos de prova. A pessoa volta a ocupar a tela depois de cada um.
+5. Oferta com a câmera limpa, sem nada disputando.
+
+**Estilo de partida:** legenda `discreta`, animações só nos momentos fortes (uma a cada 30 a 60 s), trilha muito baixa (uns 25 a 26 dB abaixo da voz) ou nenhuma.
+**Cuidado:** VSL longa gasta bastante do plano da IA. Faça a amostra de um momento forte e o padrão de 2 minutos antes do resto. Um exemplo só não vira "vários". Demonstração aparece como demonstração. Preço e condições na tela idênticos ao que ela falou.
+
+**Pedido pronto**
+```
+Edita a VSL da pasta [PASTA DA VSL]. O roteiro está em [ARQUIVO DO ROTEIRO].
+Corte primeiro, por blocos do roteiro.
+Depois, animação só nos momentos fortes: listas, passos, garantia e a virada da história.
+Faz a amostra de um momento forte e depois 2 minutos no padrão antes do resto.
+```
+
+**Perguntas de revisão**
+- Nas retomadas, alguma frase ficou sem começo ou sem fim?
+- Depois de cada prova, a tela volta para a pessoa?
+- Cada exemplo que aparece é real e prova exatamente a frase que está tocando?
+- Preço e condições escritos batem palavra por palavra com a fala?
+- Na hora da oferta, só a oferta chama a atenção?
+
+---
+
+## 7. Resposta a uma pergunta
+
+**Pra quê:** a pessoa responde uma pergunta de cliente, aluno ou seguidor.
+**Formato:** 9:16, 30 a 60 s.
+**Precisa ter:** o vídeo da resposta e a pergunta em texto ou print. **Ajuda ter:** o exemplo visual que ela cita, cores e fonte.
+
+**Blocos típicos**
+1. Cartão sóbrio com a pergunta: o texto que ela mandou (se for longo, uma redução fiel). Longe de olhos, boca e mãos, parado o tempo de ler.
+2. O cartão se recolhe para o alto e sai; a resposta fica com a tela inteira.
+3. Até três momentos da própria fala ganham destaque, um de cada vez (lettering ou peça).
+4. Uma linha de síntese com as palavras dela e saída limpa, com tempo para ler (`segura_fim` se a síntese é a última palavra).
+
+**Estilo de partida:** cartão branco com sombra leve, a pergunta em fonte de texto (não de título), legenda `padrao` na resposta.
+**Cuidado:** a pergunta é a que ela mandou, sem melhorar. Nome, foto ou @ de quem perguntou só com autorização; senão, borrado ou fora. Ninguém ganha cargo, perfil ou título que não tinha.
+
+**Pedido pronto**
+```
+Edita o vídeo da pasta [PASTA DO VÍDEO] como resposta a uma pergunta, 9:16.
+A pergunta é: "[PERGUNTA]" (ou está no print [ARQUIVO]).
+Mostra a pergunta num cartão no começo, depois me deixa em tela cheia respondendo.
+Destaca até três frases minhas, uma de cada vez. Amostra primeiro.
+```
+
+**Perguntas de revisão**
+- A pergunta escrita é a mesma que foi mandada, e dá para ler?
+- O rosto fica livre o tempo todo?
+- As ressalvas e a conclusão da resposta continuam lá?
+- Cada destaque acrescenta algo que a legenda sozinha não dá?
+- Alguém apareceu com nome, cargo ou perfil que não foi confirmado?
+
+---
+
+## 8. Produto a partir de fotos
+
+**Pra quê:** apresentar um produto com as fotos e os vídeos reais dele.
+**Formato:** 9:16 (16:9 se o produto pede largura), 20 a 45 s.
+**Precisa ter:** fotos ou vídeos do produto e a fala. **Ajuda ter:** gravação do produto em uso, logo, cores.
+
+**Blocos típicos**
+1. Vista inteira do produto, para reconhecer.
+2. Aproximação do detalhe que ela cita, sem passar da resolução da foto.
+3. O produto em uso, se ela mandou essa gravação; senão, uma segunda vista parada.
+4. Volta à vista inteira no fechamento.
+
+**Estilo de partida:** fundo limpo, poucos rótulos tirados da fala, linha de indicação só para um ponto que aparece na foto, um som por movimento.
+**Cuidado:** em foto, deslocamento e zoom moderados. A janela recortada da foto não pode ter menos pixels que a tela vai mostrar (numa tela de 1080 de largura, pelo menos uns 1080 px da foto original; se não tem, aproxime menos). Não invente um ângulo que não foi fotografado. Não mude embalagem, logo, cor, acabamento, interface nem proporção. Ilustração não aparece como se fosse o produto.
+
+**Pedido pronto**
+```
+Edita o vídeo da pasta [PASTA DO VÍDEO] apresentando o [PRODUTO], 9:16.
+As fotos e vídeos do produto estão em [PASTA DO PRODUTO].
+Começa com o produto inteiro, aproxima no detalhe quando eu falo dele e volta pro produto inteiro no fim.
+Amostra primeiro com um detalhe.
+```
+
+**Perguntas de revisão**
+- O produto está com a cara que tem de verdade (cor, logo, embalagem, proporção)?
+- Cada detalhe que aparece é o que a fala cita?
+- O zoom e o movimento ficam dentro da nitidez e dos ângulos que existem?
+- O ponto forte do produto aparece com clareza?
+- Dá para distinguir o uso real de qualquer ilustração?
+
+---
+
+## 9. Aula com diagrama que cresce
+
+**Pra quê:** explicar um conceito com um esquema que vai ganhando partes enquanto a pessoa fala.
+**Formato:** 16:9 com gravação deitada ou só áudio; com a pessoa gravada em pé, 9:16 (em 16:9 ela vira close da cabeça), 1 a 4 min por conceito.
+**Precisa ter:** o vídeo ou o áudio da aula. **Ajuda ter:** apostila ou slides aprovados, imagens citadas, cores.
+
+**Blocos típicos**
+1. O conceito apresentado (a pessoa em tela cheia, ou só o título se for só áudio).
+2. Os elementos do diagrama entrando um a um, cada um na frase que o explica; os anteriores parados no lugar.
+3. O exemplo acendendo o caminho que importa dentro do mesmo diagrama.
+4. Revisão com a estrutura completa à vista, sem elemento novo, parada uns 2 s (`segura_fim` quando é o fim do vídeo).
+
+**Estilo de partida:** cores com função fixa, rótulos de 1 a 3 palavras, setas só onde a relação foi dita, um clique suave em cada elemento novo. Diagrama pela cena `k2d_esquema` do kit 2D, adaptada (`references/animacao.md`, "Kit 2D"); outra forma de diagrama, cena própria.
+**Cuidado:** só áudio: não invente apresentador. O texto da tela estrutura; a legenda acompanha a fala; os dois nunca repetem a mesma frase longa. Diagrama só com o que foi ensinado.
+
+**Pedido pronto**
+```
+Edita a aula da pasta [PASTA DA AULA] em 16:9, com um diagrama que vai crescendo enquanto eu explico [CONCEITO].
+Cada parte entra quando eu falo dela e as anteriores ficam no lugar.
+No exemplo, acende o caminho no mesmo diagrama. No fim, mostra ele inteiro.
+Amostra primeiro com as duas primeiras partes.
+```
+
+**Perguntas de revisão**
+- Tem no diagrama alguma coisa que não foi ensinada?
+- Fica claro o que é novo e o que já estava?
+- Cada cor, lugar e rótulo quer dizer a mesma coisa do começo ao fim?
+- A pessoa e o diagrama não brigam pelo olho?
+- Dá para ler o diagrama inteiro no fechamento?
+
+---
+
+## 10. Corte de podcast ou conversa
+
+**Pra quê:** tirar de uma conversa, entrevista ou podcast um trecho que se sustenta sozinho.
+**Formato:** 9:16 (16:9 quando o contexto do lado importa), 30 a 90 s, um raciocínio completo.
+**Precisa ter:** o vídeo da conversa e o tema ou o trecho. **Ajuda ter:** outras câmeras gravadas junto, imagens de apoio, os nomes confirmados.
+
+**Blocos típicos**
+1. Quem abre a ideia aparece em destaque, com o contexto.
+2. O enquadramento acompanha a troca de quem fala, só com câmeras que existem.
+3. No exemplo citado, o apoio visual que foi mandado, e volta rápida.
+4. Uma expressão exata em lettering, uma ou duas vezes no trecho.
+5. Plano estável no fechamento, com a conclusão inteira.
+
+**Estilo de partida:** legenda `discreta`, até 3 palavras, com margem; lettering pontual; som só nas animações.
+**Cuidado:**
+- Quem fala fica identificado a cada turno. Nome só se confirmado; senão, uma identificação neutra ("convidado"). Nunca nome pela aparência.
+- Várias câmeras só depois de confirmar que estão em sincronia: ver `references/corte.md`, "Várias câmeras". O `helpers/sincronizar_cameras.py` acha o deslocamento de cada câmera (e da lapela) pela onda e deixa uma prova para conferir no olho; no `edl_manual.json`, cada trecho leva a voz de uma fonte só e o campo `imagem_de` põe a imagem de outra câmera no mesmo instante, com o som correndo contínuo. Diferença de mais de um quadro já dá eco.
+- Recortar uma pessoa de um plano aberto só se a resolução aguenta, e diga que é recorte.
+- A troca de câmera acompanha a fala ou uma reação que aconteceu na mesma hora. Nunca a cada palavra.
+- O corte aperta as pausas mortas, mas risada, tom de voz e respiro que ajudam o contexto ficam. Nunca troque a ordem das falas para montar uma afirmação que não foi feita.
+- Volume igualado entre as vozes sem mudar o jeito de cada uma.
+- Trilha, se entrar, bem baixa e sem cobrir risada ou reação. Nenhuma fala ou chamada nova.
+
+**Pedido pronto**
+```
+Corta da conversa da pasta [PASTA DA CONVERSA] o trecho em que falamos de [TEMA], 9:16, até 90 segundos.
+Quem fala é [NOMES OU "identifica como convidado"].
+Troca de câmera só quando muda quem fala. Mantém as risadas.
+Uma ou duas frases em destaque, no máximo. Amostra primeiro com uma troca de fala.
+```
+
+**Perguntas de revisão**
+- O trecho fecha um raciocínio, sem mudar o sentido do que foi dito?
+- Toda câmera, recorte e reação que aparece aconteceu naquele instante da conversa?
+- Dá para saber quem está falando, e essa pessoa está no centro?
+- A legenda fica no canto dela, sem brigar com o resto?
+- O som corre sem buraco e a conclusão chega inteira?
+
+---
+
+## 11. Composição em planos
+
+**Pra quê:** dar presença a uma palavra ou a um objeto em volta da pessoa, com profundidade (lançamento, autoridade, frase forte).
+**Formato:** 9:16 ou 16:9, escolhido antes de montar as camadas; 20 a 60 s, com os planos só nos momentos fortes.
+**Precisa ter:** o vídeo da pessoa e a mensagem a destacar. **Ajuda ter:** objetos que ela pode usar, cores e fonte, recorte já pronto.
+
+**Blocos típicos**
+1. A pessoa em tela cheia, presença.
+2. A expressão por trás do corpo e o objeto à frente, com o rosto livre.
+3. Cada plano desliza numa medida própria, preso à fala.
+4. As camadas vão saindo até ficar só uma ideia, com espaço para ler.
+5. Volta à câmera original.
+
+**Estilo de partida:** palavra grande em Montserrat 900, sombra coerente com a luz da gravação, um som no pouso da palavra.
+**Cuidado:** só depois do teste de recorte aprovado (`references/enquadramento.md`, "Portão do recorte"). Sem recorte bom, a palavra vai para o lado e não se promete texto atrás do corpo. Na entrega, "composição 2,5D em camadas".
+
+**Pedido pronto**
+```
+No vídeo da pasta [PASTA DO VÍDEO], quando eu falo "[FRASE]", põe a palavra [PALAVRA] grande atrás de mim, com profundidade.
+Primeiro me mostra o teste do recorte de uns 5 segundos.
+Depois do efeito, volta pra câmera normal.
+```
+
+**Perguntas de revisão**
+- O recorte aguenta o cabelo, as mãos e a pessoa andando?
+- A palavra e o objeto vêm da fala e deixam o rosto livre?
+- A pessoa fica no centro?
+- Os planos se mexem o bastante para dar profundidade, sem atrapalhar a leitura?
+- A volta à câmera é limpa, e o arquivo exportado mostra o efeito igual ao estúdio?
+
+---
+
+## 12. Explicação espacial em 3D
+
+**Pra quê:** quando volume, ponto de vista ou o que tampa o quê fazem parte da explicação: o interior de um objeto, peças que se separam e voltam, um caminho em volta de obstáculos, a disposição de um ambiente.
+**Formato:** 16:9 ou 9:16, 30 a 90 s, 3D só onde esclarece.
+**Precisa ter:** a fala e um rascunho ou descrição aprovados do que deve aparecer. **Ajuda ter:** modelo 3D liberado para uso, planta ou medidas conferidas, cores.
+
+O 3D é de verdade: cena sob medida em Three.js dentro do HyperFrames, com geometria, câmera e luz calculadas a cada quadro. Como montar: `references/3d.md`.
+
+**Antes de decidir:** que relação se perderia numa vista plana? Se a resposta é só "fica mais bonito", faça em 2D.
+
+**Blocos típicos**
+1. A situação apresentada, com a pessoa em tela cheia.
+2. A vista 3D começa parada, com geometria real.
+3. Um giro curto da câmera, um avanço ou as camadas se abrindo mostram a relação, presos à fala.
+4. Termina parado no ângulo que mais explica.
+5. Volta à pessoa.
+
+**Estilo de partida:** sólidos simples feitos ali mesmo no código quando não há modelo; luz que mostra as laterais; rótulos legíveis presos às peças; um som suave em cada movimento de câmera.
+**Cuidado:** a câmera não passa por dentro de nada. Enquanto o 3D não está na tela, o quadro inteiro é da pessoa; durante ele, no máximo uma janela pequena dela, afastada dos objetos. Modelo comprado, ou objeto gerado em outro serviço, só entra com o ok dela. E sem planta ou medida conferida a cena é um esquema: nenhum "2 metros" nem proporção que ninguém mediu.
+
+**Teste de uns 5 s, sempre antes do resto:** o ângulo mais difícil, uma peça passando na frente de outra e a mudança mais importante da cena, renderizados como vídeo no mesmo computador e do mesmo jeito do final (uma imagem parada não prova nada). Confira: ao girar, aparecem as laterais e a espessura; a luz reage aos volumes; sombra de contato e oclusão separam as peças; rótulos continuam presos ao que descrevem; peças que se separam voltam ao mesmo lugar.
+
+**Se o teste falhar:** descubra a camada do problema (geometria, pacote, placa de vídeo, carregamento, lentidão) e simplifique (menos peças, superfícies mais simples) sem perder a relação que precisa ser explicada. Só se este computador não rodar o 3D de jeito nenhum, use uma alternativa (vista explodida em 2D, desenho em corte, camadas planas inclinadas), diga qual foi e chame pelo nome certo. Se o 3D foi pedido com todas as letras, a troca é decisão da pessoa. Nunca troque em silêncio e nunca contrate render pago para contornar.
+
+**Pedido pronto**
+```
+No vídeo da pasta [PASTA DO VÍDEO], quando eu explico [O QUE É ESPACIAL], monta uma cena 3D de verdade mostrando [O QUE DEVE APARECER].
+O rascunho está em [ARQUIVO OU DESCRIÇÃO].
+Um giro curto de câmera quando eu falo [FRASE], e termina parado no ângulo que mais explica.
+Me mostra o teste de 5 segundos antes do resto.
+```
+
+**Perguntas de revisão**
+- A profundidade mostra algo que a fala afirma?
+- No arquivo exportado, o volume e o movimento são de verdade?
+- Medida que aparece foi conferida? Se não, está dito que é ilustrativa?
+- Luz, ângulo e rótulos bastam para entender a cena?
+- A pessoa aparece no centro quando volta?
+
+---
+
+## 13. Fala curta com destaques tipográficos
+
+**Pra quê:** um raciocínio curto (começo, virada e conclusão) em que as expressões que carregam a ideia aparecem em letra grande, uma de cada vez, enquanto a pessoa segue em tela cheia com a legenda.
+**Formato:** 9:16, 15 a 45 s, um raciocínio completo. Fala com duas ideias rende dois vídeos, não um com texto demais.
+**Precisa ter:** o vídeo falado. **Ajuda ter:** uma referência de lettering que a pessoa pode usar, cores e fonte da marca (sem elas: o lettering que ela já aprovou, ou Montserrat 900 com uma cor de destaque).
+
+**Antes de montar:** leia a fala inteira e separe de 2 a 4 expressões ditas que, lidas sozinhas e em sequência, contam o raciocínio (ex.: "gravei uma vez só" → "errei, gaguejei" → "você não viu nada"). Cada uma com as palavras exatas: número, negação e condição como foram faladas. Se a gravação só tem uma ou duas expressões fortes, fique com elas. Conte o tempo: cada expressão ocupa uns 2 s na tela (as palavras chegando, 1 s de leitura e a saída) e a próxima entra na palavra dela, então em 10 s de fala rápida cabem 3, não 4 (o exemplo acima, falado em 10 s, fica com "errei, gaguejei" → "não viu nada" → "foi uma IA"). O build avisa a expressão que fica sem tempo de leitura: tire uma ou junte duas numa peça só (a segunda vira o apoio). Mostre a lista à pessoa antes da amostra.
+
+**Blocos típicos**
+1. Abertura com a pessoa em tela cheia, sem letra grande até a primeira expressão; a legenda acompanha a fala.
+2. Cada expressão é uma peça `lettering` do catálogo (`references/animacao-catalogo.md`): `principal` com o `*destaque*` na palavra que manda, `apoio` só quando é indispensável, entrada no tempo medido na onda (rode o `helpers/palavras_na_onda.py`: cada palavra grande entra na hora em que é dita) e `posicao` longe do rosto.
+3. Cada expressão sai (`sai`) antes da próxima entrar: uma por vez, sem empilhar. Entre uma e outra a pessoa fica com o quadro limpo pelo menos um instante.
+4. Legenda `discreta` e lettering em `posicao: "topo"`. Com a legenda discreta, o padrão da peça é `"legenda_junto": true`: enquanto a letra grande está na tela, a legenda continua nas palavras que não estão escritas grandes (nenhuma frase aparece grande e pequena ao mesmo tempo, e a fala não fica sem texto). No resto do vídeo a legenda segue normal, na faixa dela.
+5. Fechamento: a última expressão (ou a chamada que a pessoa falou, no campo `chamada`) fica legível até o último quadro (`sai` no fim do corte), com `segura_fim` quando ela é a última palavra do vídeo.
+
+**Estilo de partida:** peça `lettering` com `estilo: "bloco"` (Montserrat 900, caixa alta) ou `"manuscrito"` para um tom mais leve; uma cor de destaque; entrada que cresce ou desliza pouco, sem ricochete; a pessoa em tela cheia o tempo todo, sem recorte da pessoa (texto atrás do corpo é o modelo 11, e só se ela pedir); um `pop` suave no pouso de cada expressão e trilha 22 a 24 dB abaixo da voz.
+**Cuidado:** lettering não é uma segunda legenda: a mesma frase nunca aparece grande em cima e pequena embaixo ao mesmo tempo. Nada que não foi dito, nem para "fechar" a frase. Olhos, boca e gestos livres, texto dentro da zona segura. Expressão comprida demais: divida em dois momentos ou encurte sem perder número, negação ou condição (`references/lettering.md`, "Encaixe de frase longa").
+
+**Pedido pronto**
+```
+Edita o vídeo da pasta [PASTA DO VÍDEO] como fala curta com destaques grandes, 9:16, até [DURAÇÃO] segundos.
+Escolhe de 2 a 4 expressões que eu falei e que, juntas, contam a ideia, e me mostra a lista antes de montar.
+Cada uma aparece grande na hora em que eu falo e sai antes da próxima. Me deixa em tela cheia, sem recortar o fundo.
+Estilo do texto: [ESTILO: "o que eu já aprovei", "à mão" ou a referência em ARQUIVO].
+Faz a amostra de uma expressão antes do vídeo inteiro.
+```
+
+**Perguntas de revisão**
+- Cada expressão na tela foi dita desse jeito e, fora da frase, continua dizendo o mesmo?
+- Lendo só as expressões, dá para entender o raciocínio?
+- Dá para ver o que é principal, o que é apoio e o que é legenda, sem os três brigarem?
+- Cada expressão entra junto com a fala e fica tempo bastante para ler sem pausar?
+- Uma sai antes da outra entrar, com o rosto e as mãos livres o tempo todo?