primocode 10.12.0 → 10.14.0

package/skills/maquina-de-motion/SKILL.md

@@ -0,0 +1,84 @@
+---
+nome: Máquina de motion
+descricao: o assunto vira um vídeo de motion profissional, com cenas, sons no tempo e áudio a -14 LUFS, sem você escrever JSX
+quando: motion, reel, reels, anúncio animado, anuncio animado, vinheta, motion design, after effects, vídeo de motion, video de motion
+autor: PrimoCode
+---
+Para vídeo de motion, **prefira `estudio_motion`** a escrever JSX com `estudio_ae`. Você
+preenche um JSON; o kit faz o trabalho fino (curva em toda chave, mola com quique, câmera que
+nunca para, botão que afunda, palavra-chave em itálico) e põe os sons no tempo.
+
+## O caminho
+
+1. **Procure um método.** `estudio_midia acao:"projetos"` lista as receitas do Clube do Motion.
+   Ache a mais próxima do pedido, leia a ficha (formato, duração, o que ela decide) e passe o
+   `id` dela em `receita`: a máquina segue o formato e a duração da ficha.
+2. `estudio_projeto` (criar), se ainda não há projeto.
+3. **Escreva as cenas** (o JSON abaixo). Uma ideia por cena.
+4. `estudio_motion` e **abra os quadros** (`ae/quadro-*.png`). Texto cortado, tela vazia ou
+   cor sem contraste: mude o JSON e rode de novo. A máquina já confere um quadro por cena
+   e tenta uma vez sozinha, mas olhe você também.
+
+## O JSON
+
+```json
+{
+  "id": "meu-projeto", "assunto": "Pão quente às 7h na Padaria do Joel",
+  "formato": "9:16", "duracao": 15,
+  "marca": { "cores": { "fundo": "#FFF1DC", "destaque": "#E8590C", "tinta": "#3B1F0E" },
+             "fontes": { "titulo": "Poppins", "texto": "Plus Jakarta Sans", "destaque": "Playfair Display" } },
+  "cenas": [
+    { "tipo": "gancho", "titulo": "Pão *quente* às 7h", "sub": "Padaria do Joel" },
+    { "tipo": "celular", "titulo": "Peça em *10 segundos*", "toques": ["Pão francês", "Café", "Confirmar"] },
+    { "tipo": "numero", "valor": "1.200", "rotulo": "pães assados por semana" },
+    { "tipo": "lista", "titulo": "Todo dia fresquinho", "itens": ["Pão francês", "Brioche", "Café coado"] },
+    { "tipo": "cta", "titulo": "Venha *hoje*", "botao": "Peça agora" }
+  ]
+}
+```
+
+**Você não precisa escolher o tipo da cena.** Mande `papel` (gancho · problema · processo · prova · virada · cta) e o
+conteúdo (`titulo`, `itens`, `valor`, `rotulo`, `antes`, `depois`, `texto`, `autor`, `botao`, `fala`): o diretor escolhe a
+primitiva pela metáfora do assunto, sorteia com uma semente por vídeo e foge das assinaturas dos últimos vídeos
+(`~/.primocode/studio/assinaturas.json`). Se quiser mandar, mande: `tipo`, `transicoes`, `camera`, `tipografia`, `metafora`, `semente`.
+
+- **38 primitivas** (`tipo`): gancho · cinetico · particulas · odometro · citacao · cta · carimbo · revela · heroi · explosao ·
+  icones · leque · parede_logos · celular · mergulho (a tela vira a próxima cena) · notificacoes · chat · interface (recriada
+  em camadas) · cursor · prompt · rolagem · numero · barras · linha · medidor · calendario · funil · relogio · lista ·
+  cards_pulam · laco · linha_tempo · camera_nulls · mapa · antes_depois · split · ondas · estrelas.
+- **15 transições:** encolhe · empurra · mascara · zoom · flash · persiana · chicote · desfoque · cortina · pontos · giro ·
+  tremor · abre · dissolve · corte.
+- **8 câmeras:** deriva · pulso (na batida) · mao · trilho · orbita · push · chicote · cinema.
+- **8 tipografias:** editorial · poster · tecnica · manuscrita · pesada · serifa_fina · arredondada · geometrica.
+- **Elementos reais:** `elementos: ["pão","relógio"]` (ícones 3D, GIF animado do Noto, `logos`, `site`); o diretor completa
+  até 3 ou mais. Tudo no vídeo tem a ver com o assunto.
+- **Narração que manda:** `voz: {}` e uma `fala` por cena. O whisper mede cada palavra; nada aparece antes de ser dito;
+  legenda por palavra com a palavra-chave em destaque.
+- **Som real:** efeitos CC0 por ação e assunto (cache em `~/.primocode/studio/sfx/`), cortes na batida da trilha, trilha 15 dB
+  abaixo da voz com ducking, final em −14 LUFS. Sem rede, cai nos sons leves.
+- **Layout que não quebra:** o texto é medido e encaixado na área segura; depois do render o Node confere quadro vazio,
+  texto fora, sobreposição e contraste, e refaz até 2 vezes. A folha de contato fica em `ae/folha-de-contato.png`.
+
+## A régua
+
+- **A palavra-chave vai entre `*asteriscos*`**: sai em itálico, na cor de destaque, com sublinhado.
+  Uma por título.
+- **Ritmo:** de 1 a 2,5 s por cena (`dur`); o celular pode passar um pouco. Para 15 s, 6 cenas ou mais;
+  para 20 s, 8. Não repita o mesmo tipo duas vezes seguidas.
+- **Texto curto:** título de 2 a 6 palavras; item de lista com até 4. O kit quebra a linha e encolhe o
+  corpo, mas frase longa vira parede.
+- **Cor:** sem `marca`, a paleta sai do assunto (forno, rosé, grafite com lima, floresta, petróleo, coral);
+  nunca roxo-azul genérico. Com `marca`, o kit só garante o contraste.
+- **Fonte:** qualquer uma do Google Fonts; o destaque funciona melhor numa serifada itálica.
+- **Som:** whoosh na troca, pop no estalo, clique no toque, subida no número. Nada para escrever.
+- **Voz e trilha são opcionais:** `voz` (o texto a narrar) e `trilha` ("upbeat lofi"): a trilha fica
+  15 dB abaixo da voz. O vídeo todo sai a -14 LUFS.
+
+Sem `cenas`, a máquina monta o roteiro padrão (gancho, problema, processo, prova, cta) a partir
+do assunto: serve de rascunho, mas um roteiro escrito por você sempre ganha.
+
+## Se o JSX for inevitável
+
+Um efeito que os 8 tipos não cobrem? Aí sim `estudio_ae`, leia a skill `after-effects` e
+copie o MÉTODO dos scripts do Clube. O kit (`lib/estudio/kit-ae/base.jsx`) pode ser
+concatenado antes do seu script: `novaComp`, `texto`, `forma`, `mola`, `curva`, `camera`, `troca`, `som`.

package/skills/motion-de-primeira/SKILL.md

@@ -7,43 +7,35 @@ autor: PrimoCode
 Não existe template. Cada propriedade deste vídeo é uma decisão sua, e a
 primeira decisão é **não repetir o vídeo anterior**.
 
-## O que denuncia vídeo feito por IA
-
-Não faça nada disto, em nenhum vídeo:
-
-- gradiente roxo-para-azul, e gradiente de duas
-  cores que não têm relação com o assunto;
-- tudo centralizado, do primeiro ao último quadro;
-- uma fonte só, em todos os tamanhos;
-- texto que aparece com `opacidade 0→1` e mais nada, cena após cena;
-- ícone genérico flutuando ao lado de cada frase;
-- tempo igual em todas as cenas;
-- transição igual entre todas.
-
-## O que separa motion bom de slide animado
-
-**A câmera existe.** Um zoom lento de 1.0 para 1.08 na cena inteira dá vida a
-um quadro parado.
-
-**Nada entra do nada.** Um elemento entra vindo de algum lugar (de baixo, de
-trás, de fora do quadro), com `spring` do Remotion ou easing de saída. Movimento
-linear é a assinatura da máquina: no mundo físico nada começa e para na mesma
-velocidade.
-
-**Profundidade.** Parallax (fundo devagar, frente rápido); `perspective` com
-`rotateX`/`translateZ`, ou three, para 3D de verdade.
-
-**Ritmo.** Informação simples 1,5–2,5 s; frase para ler 3–4 s; fecho 2 s.
-
-**Silêncio visual.** Um quadro com uma frase e mais nada vale mais que um com
-seis elementos. Espaço vazio é composição, não desperdício.
+## O que denuncia IA (nunca)
+
+Gradiente roxo-azul ou sem relação com o assunto; tudo centralizado; uma fonte
+só; texto que só faz `opacidade 0→1`; ícone genérico ao lado de cada frase;
+tempo e transição iguais em todas as cenas; letra cortada ou embaralhada na troca.
+
+## A régua (medida nas referências que o Joel aprovou)
+
+Números, não estilo pronto: o estilo continua seu.
+
+- **Escala:** título de 1 a 3 palavras ocupando 55–85% da largura. Nada abaixo de 2% da altura.
+- **Ritmo:** uma ideia por cena, 1 a 2 s (frase para ler 2–3 s). Com trilha, corte na batida.
+- **Entrada:** máscara (sobe de baixo, recorte reto), palavra por palavra de desfocado
+  para nítido (0,15–0,3 s cada) ou esticando com borrão; `spring` ou ataque rápido e
+  freio forte. **Saída:** a frase sai inteira (desliza, recua, corte seco).
+- **Cor:** fundo chapado, 1 tinta + 1 acento, contraste de 3:1 ou mais; até 5 cores.
+- **Segunda voz:** o apoio é menor (~4% da altura), na segunda fonte, e chega 0,25–0,5 s depois.
+- **À mão:** na palavra que é a tese, um círculo de caneta que se desenha (com ✓ ou seta).
+- **Acento vivo e câmera:** um ponto ou forma acompanha o título e vira o elemento da
+  próxima cena (a transição é o elemento). Zoom lento de 1.0 a 1.08 e parallax dão vida.
+- **Produto:** a interface é código (cartão, toggle, cursor que clica com resultado, número que conta).
+- **Explicar:** uma cena ensina desenhando (curva, gráfico, contorno com âncoras).
+- **Fecho:** a marca sozinha, centralizada, 1,5–2 s. Moldura de ferramenta (cantos,
+  timecode) só em reel de marca ou tecnologia: `moldura:"cantos"`.
 
 ## O caminho: você escreve cada cena
 
-Motion nesse nível não sai de molde: cada cena é UMA ideia desenhada para a
-fala — a interface do produto montando, o número que cresce, o objeto em 3D,
-o gráfico que mostra a ideia, a palavra gigante que se transforma. Quem
-desenha é você, em React.
+Cada cena é UMA ideia desenhada para a fala (a interface montando, o número
+que cresce, o objeto 3D, a palavra gigante). Quem desenha é você, em React.
 
 1. `estudio_projeto` (criar). A marca tem site? `estudio_site` mede cores e fontes.
 2. `estudio_midia acao:"estilos"`: monte a identidade pelo assunto em
@@ -62,23 +54,13 @@ desenha é você, em React.
    arquivo e mande o roteiro de novo.
 6. `estudio_render`. A voz, a trilha, os sons e o fundo são do Estúdio.
 
-**Variedade:** `estudio_midia acao:"efeitos"` antes das cenas; adapte e use
-como `componente`. Uma técnica nova por vídeo. Risco em 2+ linhas: traço por linha.
-
-Parte sem `componente` cai no gerativo (a tipografia anima sozinha): é a
-reserva, não o objetivo. Sem imagem é o padrão (foto só se pedirem).
-
-## Cor e tipo
-
-A paleta sai do ASSUNTO, no `estiloVisual` (um nome do cardápio ou 5 cores
-suas). Se a marca existe, as cores medidas pelo `estudio_site` mandam — não
-as que você imagina que ela usa.
+**Variedade:** `estudio_midia acao:"efeitos"`, adapte e use como `componente`; uma
+técnica nova por vídeo. Parte sem `componente` cai no gerativo (a reserva). Foto só se pedirem.
 
-Duas fontes, no máximo: display para o que grita, neutra para o que se lê.
+## Cor, tipo e conferência
 
-## Antes de renderizar
+A paleta sai do ASSUNTO (`estiloVisual`); a marca existe? As cores medidas pelo
+`estudio_site` mandam. Duas fontes: display para o que grita, neutra para o que se lê.
 
-- Os tempos das cenas batem com os tempos MEDIDOS da narração.
-- Nenhuma cena tem a mesma composição da anterior.
-- Leia o seu próprio plano e pergunte: em que este vídeo é diferente do
-  último que eu fiz? Se não houver resposta, refaça antes de renderizar.
+Antes do render: os tempos batem com a narração MEDIDA, nenhuma cena repete a
+composição da anterior, e este vídeo é diferente do último. Senão, refaça.