primocode 10.15.2 → 10.17.0

package/editor/references/direcao-por-blocos.md

@@ -0,0 +1,218 @@
+# Direção por blocos
+
+O corte diz **o que a pessoa fala**. O plano em blocos diz **o que ela mostra enquanto fala**. Sem plano, a
+edição vira uma pilha de enfeites. Com plano, cada coisa na tela tem motivo, hora para entrar e sair, e um fio
+que leva o olho de uma cena para a próxima.
+
+## Entrada
+
+- O corte aprovado e a transcrição dele (os tempos das palavras vêm da transcrição do `cut.mp4`;
+  `python3 build.py palavras` no projeto mostra tudo).
+- A posição do rosto (`face_layout.json`).
+- O briefing do vídeo (`fichas/briefing-do-video.md`): formato, destino, mensagem, oferta de verdade,
+  materiais, o que é proibido, até onde vai a autorização.
+- Se houver: a referência medida e a tabela de transferência (`references/referencia-aplicar.md`), e a triagem dos
+  materiais (`references/revisao.md`, "Triagem dos materiais").
+
+## Como dividir
+
+1. Assista e ouça antes de desenhar. Leia a fala inteira com os tempos reais. Hesitação que carrega intenção fica.
+   Anote o gancho (o que prende nos primeiros 3 s), o miolo (as ideias) e o fechamento (o que a pessoa deve fazer).
+2. Corte em blocos por **ideia**, não por tempo. Um bloco termina quando a ideia muda: começa uma lista, entra um
+   número, aparece uma prova, muda de assunto, vem a chamada.
+3. Tamanho que funciona: em anúncio e Reels, uma troca visual a cada 2 a 4 s. Em aula e VSL, a cada 4 a 8 s.
+   Bloco longo demais ganha um punch-in (zoom rápido no rosto) na palavra de ênfase.
+4. Dê um nome curto a cada bloco (b01_gancho, b02_problema, b03_prova...). Esse nome vai ser o nome da cena.
+
+## Quatro respostas para cada bloco
+
+Antes de escolher peça ou enquadramento, escreva para cada bloco:
+
+1. **A conclusão.** O que quem assiste deve entender ao fim dele, numa frase.
+2. **O olho.** O que ele segue ali: a pessoa, um objeto, uma ação, uma prova ou uma palavra.
+3. **A mudança.** A mudança visível que acompanha a ideia, quando ela pede uma. Muitas vezes não pede.
+4. **O que continua.** O fio que liga este bloco ao próximo: a voz, um objeto que segue na tela, o enquadramento,
+   uma posição na tela, uma cor.
+
+Inserção sem função clara não entra: fica a imagem original. Mudar a tela toda hora não é objetivo.
+
+## Ponto de partida pela intenção da fala
+
+| a fala é | comece por | por quê |
+|---|---|---|
+| opinião ou relato | a pessoa com folga, câmera firme | quem convence é ela |
+| procedimento | o objeto ou a tela grande, uma ação por etapa | o detalhe precisa de área |
+| comparação | os dois lados com o mesmo enquadramento e a mesma escala | senão a comparação engana |
+| revelação de resultado | o resultado real como protagonista, parado o tempo de ser olhado | a prova é o resultado, não o texto sobre ele |
+| ligação entre duas ideias | o mesmo elemento se transformando, ou uma transição com continuidade | o olho segue o fio |
+
+Se a pessoa pediu outra direção e ela é possível, a dela vence.
+
+## Que peça para cada tipo de fala
+
+Quando a pessoa não disse o que quer ver, a fala escolhe. Escreva a peça no `projeto.json` sem perguntar:
+
+| a fala tem | a peça | onde está |
+|---|---|---|
+| um número ("três formatos", "R$ 97", "em 27 minutos") | `contador` | `references/animacao-catalogo.md` |
+| uma lista ("sem custo, sem prazo, sem fila") | `lista_check` | idem |
+| passos ("primeiro... depois... por fim") | `passo_a_passo` | idem |
+| comparação ("antes era... agora...") | `antes e depois` (bloco `comparar` ou cena do kit 2D) | `references/enquadramento.md` |
+| o pedido que a pessoa faz a uma IA ("edita esse vídeo pra mim", "corta os erros") | `k2d_comando`: a barra digita o pedido na fala | `references/animacao.md`, "Kit 2D" |
+| um custo, risco, nível ou nota que sobe e desce ("custo mínimo", "risco alto") | `k2d_medidor`: a agulha vai para o valor dito | idem |
+| uma busca e a chamada ("pesquisa isso", "digita isso", "comenta a palavra") | `k2d_busca`: a barra digita o termo, o resultado entra e o selo da chamada entra na palavra dita | idem |
+| uma lista de pontos que vão sendo concluídos ("primeiro isso, depois aquilo, pronto") | `k2d_notas`: cada item é escrito na palavra e a bolinha vira check quando a pessoa conclui | idem |
+| prova (tela, resultado, depoimento que existe nos arquivos) | bloco `prova` | `references/enquadramento.md` |
+| uma frase que resume ("o vídeo inteiro foi feito por IA") | `lettering` com a palavra forte em destaque | `references/lettering.md` |
+| a chamada para agir (só se a pessoa disse uma) | `cartao_final` | `modelo-projeto/LEIA.md` |
+| só relato ou opinião, sem nada disso | câmera viva (`helpers/camera_viva.py`) e uma `lettering` nas 2 ou 3 frases que mais pesam | esta página |
+
+Nada disso se inventa: número, prova e chamada só entram se existirem na fala ou nos arquivos.
+
+## Ritmo
+
+- **Alguma coisa muda na tela a cada 2 a 4 s**: troca de enquadramento, aproximação no rosto, peça nova ou cena nova.
+  A câmera viva cuida do piso; o seu trabalho é pôr a peça certa nos trechos em que ela avisa "acima de 4 s".
+- **A pessoa fica na tela.** O padrão é a pessoa em tela cheia e a peça pequena por cima, acima da cabeça: cena do
+  kit com `area: "acima_do_rosto"` (`k2d_medidor`, `k2d_comando`, `k2d_busca`, `k2d_notas`) e `"sobre_a_pessoa": true` no `cenas_proprias`,
+  para a câmera viva não aproximar naquele trecho (`references/animacao.md`, "Por cima da pessoa"), ou lettering e
+  rótulo do catálogo. Tela cheia só de cena, sem a pessoa, é para esquema grande, antes e depois ou um respiro,
+  e no máximo uma a cada 15 a 20 s. Moldura (a pessoa pequena embaixo) é para lista e passo a passo.
+- **Uma ideia por vez.** Se duas peças disputam o olho, a mais fraca sai.
+- **Fim parado** de 1 s ou mais (`segura_fim`) quando a última peça é um resultado que precisa ser lido.
+
+## O que cada bloco pode mostrar
+
+| Quando a fala... | Mostre | Observação |
+|---|---|---|
+| Abre o vídeo (gancho) | Rosto grande + texto forte em cima (gancho ou lettering) | Nos 3 primeiros segundos já tem que ter algo escrito |
+| Afirma algo que dá pra provar | **Prova em tela cheia**: a tela do app, o print, o produto, com um rótulo curto | A pessoa sai de cena ou vira moldura pequena |
+| Explica e a pessoa continua importante | **Moldura**: pessoa num quadro menor, material do lado ou em cima | Sempre do mesmo lado no vídeo inteiro |
+| Enumera ("primeiro, depois...", "três coisas") | Lista que vai marcando item a item | Cada item entra na palavra |
+| Descreve etapas ou uma causa | O mesmo objeto mudando de estado, ou um diagrama que cresce | `references/animacao.md` |
+| Fala um número | Número que conta até o valor falado | Só número que foi falado |
+| Mostra "antes" e "depois" de um processo | Duas telas lado a lado ou uma virando a outra | Comparação justa, só com os dois lados reais (`references/revisao.md`) |
+| Diz uma frase de impacto | Lettering (a frase escrita) e a legenda some | No máximo 2 ou 3 por minuto. `references/lettering.md` |
+| Dá peso a uma palavra, lançamento, autoridade | Composição em planos: palavra em parte atrás do corpo | Só com o teste de recorte aprovado. `references/enquadramento.md` |
+| Fala de um lugar, cenário ou "de qualquer lugar" | Tela verde: a pessoa recortada na frente de outra imagem | Pede fundo razoável e custa mais tempo |
+| Cita um produto ou app | Logo ou tela do produto (se a pessoa tem direito de usar) | Pode ficar presa à mão se ela gesticula |
+| Fecha com a chamada | Cartão final com a ação (comentar, tocar em Saiba Mais, chamar no WhatsApp) | O texto do cartão repete a palavra falada e fica legível antes de sair |
+| Não pede nada | Só a pessoa, com um punch-in na ênfase | Descanso visual também é decisão |
+
+## Quem ocupa a tela
+
+- A pessoa fica com a tela inteira quando o rosto, a segurança dela ou um gesto do corpo são a mensagem.
+- A demonstração fica com a tela inteira quando o detalhe precisa de área.
+- A tela se divide quando a pessoa e a explicação precisam ser vistas juntas.
+- Nunca a pessoa num canto por padrão.
+- Quando a tela, o produto ou o resultado é o protagonista, dê a ele área para o conteúdo se ler. Um painel miúdo
+  que ninguém lê não prova nada.
+- Mostre um processo pelo que muda e pelo que se faz, não por uma fila de cartões.
+- Para chamar o olho, use uma coisa por vez: tamanho, posição, luz ou movimento.
+- Enquanto a ação principal acontece, o resto fica quieto, e o que já foi explicado fica mais discreto.
+
+## Transições em cadeia
+
+Numa explicação, cada etapa nasce da anterior. O olho não precisa procurar a coisa nova, porque ela sai da que já
+estava lá.
+
+Exemplo (com gravação de tela real): o arquivo do vídeo aparece; ele se abre na linha do tempo; os trechos de
+silêncio saem da linha do tempo um a um; a linha do tempo encolhe e vira o vídeo pronto tocando.
+
+- Um "pronto!" escrito não vale como mostrar a coisa pronta. Se não existe gravação do resultado, não
+  invente: mostre o que existe e diga o que faltou.
+- Na passagem da tela cheia para a moldura, o rosto não dá salto de posição. A moldura para de se mexer antes de
+  outra coisa importante começar.
+- Se a transformação não acrescenta sentido, use corte seco. Transição decorativa não entra.
+
+## Resultado que dá para olhar
+
+Quando a fala revela um resultado (o pedido chegando, o vídeo editado, o produto pronto), ele fica grande e
+parado o tempo de ser inspecionado antes da próxima troca: pelo menos 1,5 s depois de completo, mais se tiver
+texto para ler. Só resultado real, dos arquivos da pessoa. Nada de tela de sucesso, clique ou reação desenhados.
+
+## Continuidade
+
+- Mesma fonte, mesmas cores e mesmo lado da moldura do começo ao fim.
+- Objeto que muda de estado não muda de cara nem de lugar.
+- Cada elemento sai antes do próximo bloco começar. Nada fica "esquecido" na tela.
+- Ao sair de uma moldura ou de um zoom, tudo volta ao normal (sem ficar meio torto ou meio grande).
+- Depois de cada inserção, a volta à pessoa tem o mesmo enquadramento de antes.
+- Se a cena já escreve a fala, a legenda some naquele trecho.
+- Nada aparece antes da palavra que chama (pode antecipar até 0,15 s).
+
+## Limpar sem esvaziar
+
+Quando tem muita coisa disputando a tela (pessoa, legenda, ícones, cartões, títulos):
+
+1. Descubra quem carrega a ideia daquele instante e dê mais tamanho a ele.
+2. O que pertence à fala seguinte espera a vez.
+3. O que repete sai.
+4. O contexto útil fica, mais discreto.
+5. O espaço que sobrou não fica vazio: vai para o resultado, ou para mostrar de onde a coisa vem, o gesto e o que
+   acontece depois.
+
+## Auditoria de tempo das inserções
+
+Quando imagens, cartões ou títulos chegam cedo ou tarde:
+
+1. Para cada elemento, ache a frase que o justifica, no tempo da fala real do corte (nunca do roteiro).
+2. A entrada prepara ou acompanha essa frase (até 0,15 s antes). Fica na tela o tempo de ser lido e sai quando
+   já cumpriu o papel.
+3. Dois elementos no mesmo momento: proponha uma ordem, com prioridade clara.
+4. Elemento sem frase que o justifique vai para a lista do que sai. Não invente motivo.
+5. Mostre uma tabela curta antes de mexer:
+
+   | elemento | frase ligada | entra | sai | o que fazer |
+   |---|---|---|---|---|
+   | rótulo "App" | "esse aplicativo aqui" (00:14,2) | 00:13,1 → 00:14,1 | 00:16,0 | atrasar a entrada |
+   | carimbo | nenhuma | 00:21,0 | 00:22,4 | tirar |
+
+6. Mexa só no tempo (`em` e `sai` no `projeto.json`). Design, ordem da fala e cortes aprovados ficam. Mostre os
+   trechos corrigidos no estúdio.
+
+## Saída
+
+Grave `STORYBOARD.md` na pasta do projeto, com o modelo de `fichas/plano-em-blocos.md`:
+
+1. As regras do vídeo (formato, rosto, zona segura, fonte, cores, legenda, som, trilha).
+2. A tabela dos blocos: nome, tempo (início e fim no corte), fala, conclusão, o que o olho segue, o que aparece,
+   texto na tela, animação, som, o que continua, material.
+3. A lista do que falta (prints, fotos, logos): peça numa mensagem só e siga com o que não depende disso.
+
+Vídeo longo ou com muitas cenas próprias: use também a planilha de cenas (`fichas/planilha-de-cenas.csv`), uma
+linha por cena, com a situação de cada uma.
+
+Para a pessoa, mostre uma versão curta: uma linha por bloco, em palavras do dia a dia ("0:00 a 0:03, você falando
+e o título grande em cima"). Se ela pediu para aprovar o plano, espere. Se já autorizou fazer tudo, conte e siga.
+
+## A amostra
+
+Escolha o trecho pela dificuldade, nunca só os primeiros segundos. Ele precisa ter a virada mais importante, um
+raciocínio inteiro explicado e a volta à pessoa falando. Uns 8 s em edição simples, uns 15 s com motion. Diga
+qual é e por quê em uma linha.
+
+Monte no estúdio (`references/estudio.md`), sem render. Confira com `fichas/conferencia-da-amostra.md`, tocando.
+
+- A pessoa pediu para aprovar antes: mostre e espere.
+- Já autorizou fazer tudo: a amostra é teste interno. Confira pelos critérios e siga para o resto.
+- Surgiu uma decisão que muda o resultado e não estava autorizada (a técnica não funciona, o formato teria de
+  mudar, o recorte não aguenta): pare e pergunte.
+- Nunca trate silêncio como aprovação. Nunca chame a sua conferência de "aprovado pela pessoa".
+
+## Revisão tocando
+
+1. Toque o trecho com som, no tamanho do celular.
+2. Pare em cada momento em que a atenção passa de uma coisa para outra. Você sabe dizer o que o olho procura ali e
+   por que isso combina com o que está sendo dito?
+3. Um enfeite secundário roubando o olhar: primeiro mude a hora da entrada ou a intensidade dele. Só depois pense
+   em acrescentar outra coisa.
+4. Na demonstração alguma coisa está acontecendo, e o resultado fica parado tempo bastante para ser olhado.
+5. Rosto, conteúdo e legenda não brigam por área.
+6. Na chamada final, o texto aparece inteiro e fica o bastante para ser lido; a saída só começa depois.
+
+## Quando a edição está confusa
+
+Se a pessoa disser que ficou poluído, confuso ou "parece slide", faça primeiro o diagnóstico só de leitura de
+`references/revisao.md` (até cinco prioridades, cada uma com uma saída: deixar, mover, encolher, atrasar ou
+remover). Proponha remover antes de acrescentar e mostre a versão enxuta de um bloco como amostra.