Cartoon: estudo de handoff do personagem (.studies) e AGENTS.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Mateuus
2026-11-18 05:08:57 -03:00
co-authored by Claude Opus 5.5
parent 215faa331c
commit b923132a69
46 changed files with 3775 additions and 0 deletions
@@ -0,0 +1,109 @@
# Tarefa: subir o personagem cartoon (corpo e MÃOS) ao nível de uma ilustração de referência
Você vai trabalhar num **workspace isolado** (pasta `workspace/` deste pacote), sem acesso ao projeto
original. Responda e comente em **português do Brasil**; nomes de código (variáveis, funções, tipos,
arquivos) em **inglês**.
## Contexto
Temos um gerador de vídeos curtos verticais (9:16) em estilo "cartoon explicativo". Cada personagem é um
**componente React que desenha SVG puro** (`workspace/src/CharacterFigure.tsx`). Ele não é uma imagem pronta:
é montado por peças a partir de uma ficha de aparência (`CharacterLook`, em `src/character.ts`) e animado por
um **rig** de parâmetros contínuos (`src/rig.ts`: rosto `FaceParams` e corpo `BodyParams`, braços e pernas em
dois segmentos). As poses e ações (`src/motion.ts`) mexem nesses parâmetros quadro a quadro, e a boca segue a
fala (`src/lipsync.ts`). O vídeo final é renderizado quadro a quadro pela Remotion (Chrome headless), então
**tudo precisa ser função pura dos parâmetros** (nada de aleatório sem semente, nada de relógio).
O mesmo personagem aparece em close (só rosto e tronco), meio corpo e corpo inteiro, de frente para a câmera.
## Referência (o NÍVEL de acabamento que queremos)
Pasta `referencia/`: quadros de um vídeo de outra série (1080×1920) e recortes ampliados em
`referencia/recortes/` (mãos segurando, joinha, mão com prancheta, apontando, close de mãos, braços cruzados,
rosto). `00-video-inteiro-…png` mostra o vídeo todo.
**Copie a qualidade, não o conteúdo.** Não reproduza aqueles personagens, nomes, roupas, logotipos ou cenas.
O que importa nelas:
- **Proporção:** cabeça grande (≈ 1/3 da altura no corpo inteiro), pescoço visível e proporcional, ombros
largos e arredondados, tronco em "pera".
- **Sombreado cel em 2 tons**, luz de um lado só, sombra levemente fria, **sem contorno preto** (a borda é o
tom mais escuro da própria cor).
- **Rosto:** orelha com dobra interna; nariz como curva simples; rugas da testa como arcos suaves no tom da
pele; sobrancelha como forma cheia; pálpebra pesada; olhos com esclera branca; óculos de aro grosso com
reflexo.
- **Roupa com construção:** gola, zíper ou botões, costuras, 2–3 dobras (manga, cotovelo, barriga), barra;
pano pendurado (toalha) com dobras e sombra própria.
- **MÃOS (o problema principal):** formas macias e orgânicas, dedos de comprimentos diferentes que afinam na
ponta, nós em arco, polegar nascendo da base da palma, unhas visíveis quando a vista mostra, mão grande
(≈ do nariz ao queixo). Segurando objeto: o polegar por cima e os dedos por trás (objeto entre as camadas da
mão). Objeto largo (livro, camisa dobrada) com as duas mãos pelas bordas. Joinha com o punho de lado e os
dedos dobrados em fileira. A **mão sai de dentro da manga**: a manga termina numa borda com espessura e
abertura escura, o pulso afina e entra nela, e a manga faz sombra no pulso.
## Onde estamos (pasta `nosso/`)
- `01-folha-antes.png` → `02-folha-atual.png`: em cima a referência, embaixo o nosso, nos mesmos 6
enquadramentos. Melhoramos muito, mas um olhar rápido ainda separa os dois.
- `03-maos-ref-antes-depois.png`, `04-formas-de-mao-3-rotacoes.png`: estado atual das mãos (biblioteca
`src/hands.tsx` com formas `relaxed`, `open`, `point`, `thumbs_up`, `grip`, `pinch_edge`, `pinch_low`,
`fist`, `on_face`, giradas pelo pulso).
- `05-poses-camadas.png`: a ordem das camadas do braço (`src/limbs.ts`, `armLayer`) para a mão nunca sumir
atrás do corpo.
- `08-folha-de-poses-do-workspace.png`: saída do script deste workspace (12 poses).
O que o dono do projeto ainda reprova:
1. **Mãos** ainda parecem recortadas/coladas: formas duras, sombra em cunha, dedos "salsicha". Exemplos na
folha 08:
- braços cruzados viram um losango de dedos;
- no apontar, a mão some;
- o martelo e o ramo atravessam a túnica, e o cabo não fica claramente dentro do punho;
- no pensar e no tapar a boca, a mão parece um bloco.
2. A **emenda pulso → manga** às vezes mostra corte ou degrau quando o braço gira.
3. O **corpo inteiro** ainda parece "boneco de recorte" perto da referência:
- pouco volume na roupa;
- pernas e braços muito retos;
- sapato simples;
- sobrancelhas claras viram mancha (veja o idoso de barba branca).
4. Falta **textura de ilustração**: a referência tem degradê suave dentro das áreas e um leve granulado. A
sombra cel deve continuar, mas com transição menos "vetor de ícone".
## O que fazer
1. Estude a referência (abra as imagens) e liste, por item acima, o que muda no desenho.
2. Reescreva o que precisar em `src/CharacterFigure.tsx`, `src/hands.tsx` e `src/limbs.ts` (e, se
necessário, presets de pose em `src/rig.ts`) para chegar ao nível da referência. Pode criar arquivos novos
em `src/`.
3. Use `npx tsx render-sheet.tsx` (corpo inteiro) e `npx tsx render-sheet.tsx close` (close) para gerar
`out/sheet-*.svg`/`.png` e **olhe as imagens a cada rodada**. Acrescente poses ao `CELLS` do script se
precisar (ex.: apontar para o outro lado, acenar com a outra mão, mãos na cintura, segurando celular).
4. Pare quando, lado a lado com os recortes da referência, a mão e o corpo não se separarem pela qualidade do
desenho.
### Regras que NÃO podem quebrar (o projeto real depende delas)
- **Mesma interface pública:**
- `CharacterFigure({ look, expression?, pose?, item?, t?, state?, shadeSide?, gesture? })`;
- viewBox `0 0 200 440` com os pés em (100, 440);
- `HandsInsert({ look, item?, t?, shadeSide? })` desenha o close de mãos num viewBox 1080×1080.
- **Tipos e campos:** `CharacterLook`, `FaceParams`, `BodyParams` e os nomes de poses e expressões continuam
existindo. Campo novo só **opcional**, porque personagens já salvos precisam continuar abrindo.
- **Rig:** o desenho continua dirigido pelo rig. Expressões, poses, fala (boca) e movimento (andar, acenar,
martelar, pular, sentar) precisam funcionar; a sombra acompanha a cabeça virando (`headTurn`) e as dobras
acompanham o braço.
- **Sem dependências novas no desenho:** só React e SVG, sem imagens rasterizadas e sem bibliotecas novas.
- **Sem custo alto de render:** nada de `feGaussianBlur` ou filtros SVG pesados repetidos por quadro (o vídeo
renderiza 30 quadros por segundo; hoje um trecho de 4 s leva ~4 s). Degradê linear ou radial e textura
barata são aceitos.
- **Função pura e camadas:**
- nada de `Math.random()` nem relógio; mesmos parâmetros = mesmo desenho;
- braço, mão e objeto na mão nunca somem atrás do tronco, da barba ou de acessório quando o personagem está
de frente; mantenha a lógica de `armLayer` (ou melhore-a).
## Entrega
- A pasta `workspace/src/` com os arquivos alterados ou novos (vou copiá-los de volta para o projeto).
- `out/sheet-full.png` e `out/sheet-close.png` finais, e uma folha **referência × seu resultado** (os recortes
da referência ao lado das mesmas situações no seu desenho).
- Um resumo curto: o que mudou em cada arquivo, campos novos (se houver) e o que ainda não ficou igual.