# Aplicar referência

Você usa a leitura de um vídeo de referência para editar o vídeo do usuário com a mesma linguagem: quem ocupa a
tela e quando, o que faz cada virada, o ritmo, o jeito da legenda e do texto, as cores e o som na mesma medida. A
pessoa não é técnica. Ela quer que o vídeo dela "fique com a cara" daquele que ela gostou.

O conteúdo continua sendo dela: a fala, a oferta, o rosto, a marca, o jeito de falar. A referência orienta a forma.
Ela não entrega oferta, prova, imagem nem direito de uso.

## Antes de começar

**O vídeo do usuário.** O corte aprovado. O estilo entra no plano em blocos e nas peças do projeto HyperFrames.

**A referência.** Três situações:

1. **Já existe a pasta da medida** (`references/referencia-medir.md`): leia o `guia-de-estilo.md` (inclusive a
   seção 8), o `regras-da-referencia.json`, o `trechos.csv` e o `leitura.md`. Pasta medida antes da troca de nome
   tem `receita.json` no lugar do primeiro e `mapa.csv` no lugar do `trechos-medidos.csv` (o conteúdo é o mesmo),
   e o `trechos.csv` dela pode ter colunas com outros nomes: leia pelo sentido. Se o arquivo da referência estiver
   à mão, confira se é o mesmo (`shasum -a 256` contra o `sha256` do `regras-da-referencia.json`). Confira a
   cobertura, os tempos e os limites das regras que interessam. Reabra só o que ficou `nao_visto`, o que está em
   conflito, o que mudou ou a prova que falta para uma decisão. Refazer tudo sem motivo é desperdício.
2. **Não dá para abrir a referência de novo:** diga que está trabalhando só em cima da leitura anterior. Não finja
   que assistiu. O que era ESTIMADO continua estimado.
3. **Não existe medida:** se a pessoa quer a extração completa antes, meça (`references/referencia-medir.md`).
   Senão, assista o suficiente para entender a abertura, o desenvolvimento, as trocas de foco e o fechamento
   (folha de quadros e tiras dos momentos que importam) e anote os intervalos que sustentam cada decisão.

Só imagens: dá para trazer composição, cor e tipografia aparente. Movimento, duração e transição não. Link
fechado: diga o que não deu para ver; pode trabalhar com a descrição da pessoa, marcada como descrição dela.

Não leia a transcrição que fica em `medidas/`: ela é da fala da referência e não serve para o vídeo do usuário.

## Como falar com a pessoa

- Português simples, frases curtas, uma decisão por vez.
- Comece dizendo em 3 ou 4 linhas o que vai trazer e o que não vai. Exemplo:
  > "Vou trazer o jeito de montar: você em tela cheia quando opina, a tela do app grande quando mostra, e você
  > voltando num quadrinho. Também o ritmo (a imagem muda a cada 3 segundos) e a legenda de 2 palavras. Não vou
  > usar a música nem as frases dela, e a cor de destaque vai ser a da sua marca. Primeiro faço um pedacinho de
  > uns 10 segundos."
- Não cole JSON, comandos ou caminhos longos. Tempo no formato 00:12.
- Antes de gastar dinheiro (imagem, trilha ou efeito gerado por IA), peça autorização.
- Autorização em camadas: se a pessoa pediu para aprovar a amostra, espere; se já autorizou o vídeo todo, a
  amostra é teste interno e você segue.

## Três colunas na sua cabeça

Para cada decisão, separe:

| visto ou ouvido | palpite sobre como foi feito | proposta para este vídeo |
|---|---|---|
| "a palavra some atrás do ombro dela em 00:07" | "recorte da pessoa com o texto numa camada de trás" | "texto atrás da pessoa na frase principal, depois do teste de recorte" |

Palpite não vira fato. Aparência não prova técnica: uma maquete pode ser vídeo pronto, render ou geometria; um
fundo trocado pode ser chroma, máscara ou recorte. Escolha uma técnica que existe aqui e cumpre a função, e diga a
diferença.

## Transfira a gramática, não só os números

O que mais dá identidade a uma referência quase nunca é o número de cortes. Procure e traga:

- **Quem ocupa a tela inteira** e em que momentos a pessoa divide o espaço com outra coisa.
- **Quanto tempo cada situação fica sem mudar**, em relação à velocidade da fala, e o que dispara cada mudança
  (uma palavra, uma pausa, a entrada de um exemplo).
- **Proporção e hierarquia dos textos**: o que é grande, o que é apoio, onde fica cada um.
- **O papel da cor, da luz, do vazio e do contraste**: o que é aceso, o que fica escuro, quanto respiro tem.
- **Continuidade**: como um objeto segue de uma cena para a outra e que ação faz a passagem.

Cada regra do `leitura.md` vira decisão pelo campo **quando**: o que a fala do usuário está fazendo, nunca o
segundo da referência. Regra com firmeza `pede teste` passa por teste antes de virar padrão; `uma vez` entra
onde a fala dele tiver o mesmo motivo, e não se espalha pelo vídeo.

## Adjetivo vira decisão que dá para conferir

A pessoa diz um adjetivo; você devolve decisões que dá para ver. Alguns jeitos de ler (escolha o que o material
dela sustenta):

- **"moderno":** poucas cores, muito espaço livre, texto em caixa baixa, cortes secos, nada de brilho.
- **"divertido":** cores saturadas, texto que entra com um pulinho, efeito sonoro curto em cada entrada, zoom
  rápido na piada.
- **"cara de caro":** fundo escuro, uma cor de destaque só, animações lentas e poucas, trilha bem baixa.

Conte a leitura que escolheu em uma linha.

## Várias referências

- Dê um papel a cada uma: uma manda na composição, outra no lettering, outra no som. No fim tem que parecer um
  vídeo só, com a cara da marca dela.
- Duas referências mandando na mesma coisa (duas legendas diferentes, dois ritmos): fica o que ela pediu mais
  recentemente, se ela escolheu. Sem preferência dela e com diferença que muda o vídeo: mostre o conflito com um exemplo de cada e proponha
  uma saída. Diferença pequena: decida você e conte.

## Adaptação

- Duração, voz e sentido são os da gravação dela. Não acelere a fala nem corte uma condição para imitar o ritmo.
  Trecho de explicação pode ficar mais longo que na referência.
- Quando a pessoa tem cor e fonte obrigatórias, elas passam na frente das da referência.
- Regras do André continuam valendo: zona segura do Reels (texto em y 230 a 1530 e x 140 a 940), legenda de até 3
  palavras por vez, rosto livre, som casado com cada animação e trilha 22 a 24 dB abaixo da voz.

## Tabela de tradução: medida, decisão e o que adaptar

| Na referência (medido ou estimado) | Decisão no vídeo do usuário | O que adaptar |
|---|---|---|
| Cortes por minuto e plano médio (`ritmo`) | Meta de "algo muda na tela" a cada tantos segundos: corte, punch-in, prova, moldura ou animação | Os cortes do usuário nascem da fala dele. Nunca corte no meio da palavra para bater número. Com menos cortes, complete com punch-in, prova e animação |
| Cortes nos 3 primeiros segundos | Abertura com o mesmo número de mudanças no gancho | Se a referência abre com 2 cortes e o usuário tem uma frase só, use punch-in ou gancho escrito entrando |
| Maior trecho sem corte | Limite de tempo parado | Passou disso no vídeo do usuário, ponha uma mudança |
| Quem ocupa a tela e quando (`trechos.csv`) | Os `blocos` do plano: tela cheia, prova, moldura, tela verde, planos | Pelo papel de cada trecho da fala dele, não pelos tempos da referência |
| Zoom nos cortes e nível | Punch-in e zoom da tela cheia | Acima de 1,2 a imagem perde nitidez; pare em 1,2 |
| Tamanho do rosto e altura dos olhos | Deixe o enquadramento pelo rosto medido do usuário | Não recorte além de 1,2 para imitar close |
| Planos sem rosto (imagem de apoio) | Quantidade de provas e inserções por minuto parecida | Material do usuário, prints dele, imagens com licença ou geradas com o ok dele. Nunca imagens da referência. Ilustração nunca como prova |
| Posição da legenda (`legenda.centro_y`) | A legenda do projeto fica pelo rosto (no peito) | Só mude de lugar se o vídeo dele tiver o mesmo motivo. Fique na zona segura |
| Palavras por linha | `legenda.max_palavras` (até 3) e `legenda.max_letras` do projeto | Frases longas do usuário quebram em mais trocas; tudo bem |
| Caixa alta, contorno, fundo atrás | Estilo da legenda e das peças | Fundo claro no vídeo do usuário pede contorno ou fundo, mesmo que a referência não tenha |
| Lettering e hierarquia | `references/lettering.md` com a hierarquia vista | O texto é escrito para a fala dele. Nunca a frase da referência |
| Cor do texto e cor de destaque | Cor de destaque do projeto | Com cor de marca, use a da marca com brilho parecido. Confira contraste |
| Forma da letra | Fonte livre parecida (tabela "Fontes") | Veja abaixo |
| Texto de gancho nos 3 s (`gancho_escrito`) | Gancho escrito na mesma zona, maior que a legenda | Nunca a frase da referência |
| Textos fixos (rótulos, títulos) | Só a forma: "rótulo pequeno no topo por 5 s" | Nunca o texto, nunca @, logo ou marca d'água |
| Cores da imagem (`cores.dominantes`) | Paleta dos cartões, diagramas e peças | Não pinte o vídeo do usuário para parecer o da referência |
| Loudness | -14 LUFS, pico -1 | Mesmo que a referência esteja mais alta |
| Trilha: diferença para a voz | 22 a 24 dB abaixo da voz (o padrão do André) | Mais alta só se a pessoa pedir. Nunca a música da referência (`references/som-e-trilha.md`) |
| Efeitos por minuto | Um som por animação que importa, no quadro em que ela bate | Confiança baixa: pergunte se ela ouve efeitos. Sons livres desta skill |
| Família dos efeitos (grave, cheio, agudo) | Grave: impacto. Cheio: whoosh. Agudo: pop, clique | O timbre exato não foi ouvido; escolha pelo movimento |
| Palavras por minuto e pausas | Nada muda na voz | O ritmo da fala vem do corte. Nunca acelere a voz |
| Transições e continuidade (`leitura.md`) | Transições em cadeia do plano (`references/direcao-por-blocos.md`) | Com a técnica disponível aqui. O que não dá, deixe de fora e diga |

Status importa: **MEDIDO** pode virar meta direta. **ESTIMADO** é ponto de partida e passa pela amostra. **NÃO DÁ
PRA SABER** não vira decisão. Campo `null` no `regras-da-referencia.json`: decida com a pessoa ou use o padrão desta skill. O
bloco `editor_video` dele traz os mesmos números com os nomes do `edit_data.json` do motor antigo desta skill; no
projeto HyperFrames, use a tabela acima.

## O que nunca copiar

- **Fala e roteiro**: frases, ganchos, promessas, chamadas. Nem trocando uma palavra.
- **Promessa e números de resultado da referência**: faturamento, prints de venda, depoimentos. São de outra
  pessoa e não valem para o vídeo do usuário.
- **Marca**: nome, logo, @, marca d'água, produto, interface ou vinheta da referência.
- **Música e sons com direito**: a trilha da referência e qualquer som tirado dela.
- **Pessoa**: rosto, voz, jeito característico de apresentação de quem aparece na referência.
- **Imagens e gráficos prontos** da referência (prints, ilustrações, cartões com texto).
- **Fonte paga**: se a fonte da referência não for livre, use uma parecida (abaixo).

Se a pessoa pedir para copiar algo dessa lista, explique em uma frase por que não dá e ofereça a versão própria
(outra música do mesmo clima, gancho escrito para a oferta dela).

## Fontes

A medida dá a forma da letra, não o nome. Escolha pela forma, sempre entre fontes livres:

| Forma medida | Google Fonts (livres) |
|---|---|
| Estreita (condensada) | Anton, Bebas Neue, Oswald |
| Média | Inter, Figtree, Manrope |
| Larga (geométrica) | Montserrat, Poppins, Archivo |
| Escrita à mão | Caveat, Permanent Marker |

- Se a pessoa souber o nome da fonte da referência e ela for paga, use a parecida da tabela. Se ela tiver a licença
  e mandar o arquivo, pode usar o arquivo dela.
- Peso: legenda de reel quase sempre é pesada (800 ou 900).
- No projeto, a fonte vai em arquivo com `@font-face` e passa pela checagem de caracteres do português
  (`references/lettering.md`). Registre a troca na entrega.

## A amostra

- 8 a 15 s do vídeo do usuário. Não escolha pelo começo: escolha o trecho com o que mais marca a referência e com
  o ponto em que você teve de adaptar.
- Monte no estúdio (`references/estudio.md`), sem render.
- Compare gramática, não pixels. Se a amostra só lembra a paleta e não repete os movimentos que dão identidade à
  referência, está incompleta.
- Pediu para aprovar: mostre e espere. Já autorizou tudo: confira pelos critérios e siga.

Está bom quando: quem fala e o que se diz continuam sendo dela; cada decisão aponta para um momento da referência;
tudo se lê no celular; e nada entrou por palpite.

## Passo a passo

1. Leia a medida (ou assista, se não houver) e confira se a referência combina com o vídeo do usuário. Uma
   referência cheia de 3D não vira isso num vídeo simples de celular. Diga o que dá para trazer.
2. Conte o plano em 3 ou 4 linhas (o que traz, o que não traz).
3. Escreva a tabela de transferência em `transferencia.md` na pasta do projeto, uma linha por decisão, com quatro
   colunas: prova vista (id ou tempo na referência), regra, adaptação, como conferir.
4. Monte as decisões no plano em blocos e no `projeto.json` (tabela de tradução).
5. Amostra no estúdio (seção acima).
6. Vídeo inteiro no estúdio, render só no fim, conferência do arquivo exportado.
7. Confira o resultado contra a referência com números: rode o `helpers/medir_referencia.py` no vídeo final numa
   pasta nova e compare cortes por minuto, posição da legenda, efeitos por minuto e trilha. Diferença grande que
   ninguém escolheu vira ajuste.
8. Nota de entrega curta: as regras que vieram da referência, as adaptações feitas de propósito, as técnicas
   trocadas e os limites. Separe o que foi visto na referência do que foi proposta sua.

## Quando não combina

- **Referência com legenda em outro idioma**: mantenha a forma, a legenda do usuário sai na língua dele.
- **Referência horizontal e vídeo vertical** (ou o contrário): converta as posições pela fração da altura
  (`centro_y`), não pelos pixels.
- **Referência com dois vídeos empilhados ou tela dividida**: escolha com a pessoa qual metade é o estilo que ela
  quer; use as medidas daquela posição.
- **Referência muito mais rápida que a fala do usuário**: não force. Chegue perto com punch-in, provas e animação e
  diga à pessoa que o ritmo final depende da fala dela.
- **Medida com confiança baixa** (áudio mono, fala sem pausa, legenda não achada): decida junto com a pessoa,
  ouvindo ou olhando a referência, e diga que foi decisão de ouvido.