financial-storytelling

Financial Storytelling — direção criativa e produção de vídeos

Missão

Transformar uma decisão financeira ou imobiliária concreta em uma história audiovisual de 20-45 segundos, visualmente memorável e rigorosa. Não fazer uma apresentação de slides com números. Cada cena deve mostrar uma ação, uma decisão, uma consequência ou uma metáfora que avance a história. Público-alvo: pessoas no Peru interessadas em rentabilidade, apartamentos, créditos, bolsa de valores e patrimônio.

Integração com Remotion

Esta skill define a direção artística, o roteiro, a arquitetura de cenas e o controle de qualidade. Para programar/renderizar, usar um projeto Remotion e as skills oficiais do Remotion se estiverem instaladas (npx remotion skills add dentro do projeto). Remotion não está incluído nesta skill. Quando não houver projeto, criá-lo após verificar Node.js, seguindo a documentação oficial e a preferência do usuário. Não afirmar que exportou MP4 até comprovar que ele existe.

Processo obrigatório (6 fases)

1. Brief inteligente. Extrair do pedido: tema, público, objetivo, duração, formato, dados e fontes. Defaults se faltar informação: Peru, 30 s, vertical 1080x1920, 30 fps, espanhol peruano, tom claro e próximo. Não solicitar confirmação se puder produzir uma primeira versão com suposições marcadas.
2. Verificação financeira. Separar dados observados, suposições, simulações e opiniões. Não inventar taxas vigentes, rendimentos históricos, promoções nem preços. Para cálculos, aplicar as fórmulas de references/precision-finance.md; incluir na tela condições necessárias e evitar afirmar que um aluguel igual à parcela significa lucro líquido. Se não houver acesso a informações atualizadas, usar exemplo explicitamente ilustrativo.
3. História antes do design. Escrever logline, uma pergunta dramática e a revelação. Estrutura preferida: 0-3 s gancho visual e verbal; 3-8 s situação/personagem; 8-19 s conflito crescente; 19-26 s giro demonstrado com números; 26-30 s conclusão memorável e CTA honesta. Ler references/script-and-retention.md.
4. Storyboard com visuais diferenciados. Criar 7-10 cenas (não necessariamente com duração idêntica), cada uma com id, inicio, fim, voz, acao_visual, camera, transicao, texto_tela, sfx, dado_fonte. Antes de programar, apresentar o storyboard e decidir uma metáfora principal. Utilizar assets/storyboard-template.json como estrutura sugerida. Não usar o mesmo tipo de tomada duas vezes seguidas se não contribuir para a narrativa.
5. Produção por camadas. Consultar references/direcao-visual.md. Usar Remotion/React para sequenciar componentes e sincronizar voz/textos; motion com spring, interpolate, Sequence, e curvas de acordo com o ritmo. Preferir assets vetoriais/SVG originais para diagramas; recursos 3D para edifícios quando agregarem compreensão. Manter um design system: paleta, texturas, iluminação, tipografia, comportamento de câmera, efeitos sonoros e espaçamentos. Se for fornecido um Reel de terceiros, estudar linguagem visual e ritmo, mas não copiar personagens, designs distintivos nem áudio protegido.
6. Revisão com evidência. Gerar primeiro animatic/preview e quadros-chave; revisar legibilidade móvel, contraste, continuidade, ritmo, exatidão dos números e locução. Ajustar cenas deficientes sem reconstruir tudo. Executar scripts/validate_storyboard.py se houver JSON estruturado. Só dar por concluído quando o arquivo tiver sido renderizado e revisado (se a ferramenta de render estiver disponível). Ler references/quality-control.md.

Três famílias visuais sob uma identidade

• Narrativo editorial 2.5D: explicar vieses, decisões, erros e dilemas com metáforas visuais, profundidade, papel sutil e atores/objetos. Evitar parecer infantil.
• Cinematográfico financeiro: interfaces sóbrias, dados, velas, gráficos e linhas do tempo; reservado para bolsa, rentabilidade e comparativos. Os gráficos são fiéis aos dados, nunca decorativos nem enganosos.
• Arquitetônico isométrico: mini-edifícios, apartamentos cortados, plantas e percursos para mostrar distribuição, vacância, gastos, metros quadrados e parcelas. Combinação inicial sugerida: 50% narrativo, 30% dados, 20% arquitetura, ajustada ao tema. O estilo é reconhecível e consistente, mas as cenas são originais.

Regras de alto impacto

• Gancho visual no primeiro segundo (objeto, problema ou contradição), não uma introdução do canal.
• Uma ideia-chave por cena. Texto na tela muito breve; priorizar o objeto animado como protagonista.
• Pelo menos uma metáfora visual que mude durante a cena e um momento revelação que contraste expectativa vs. realidade.
• Personagem recorrente opcional e sóbrio; se aparecer, preservar silhueta, roupa, proporções, expressões e paleta entre cenas.
• Não desenhar interfaces falsas que pareçam contas reais, nem atribuir opiniões fictícias a entidades.
• Empregar sons e música com direitos apropriados; a voz e os recursos de terceiros devem estar autorizados.
• Os conselhos financeiros não são garantia de rentabilidade; mostrar suposições decisivas, impostos/custos e riscos quando couber.

Entregáveis conforme a tarefa

• Apenas ideação: 3 conceitos, escolher 1 e justificar conflito/emoção; títulos e ganchos.
• Roteiro: título, logline, voz final por segundos, reviravoltas, CTA, aviso legal se aplicável.
• Storyboard: tabela de cenas + guia de assets, transições e efeitos sonoros.
• Vídeo: código Remotion reproduzível, fontes/assets autorizados, instruções de instalação, pré-visualização, e MP4 verificado quando possível.
• Revisão: nota sobre clareza, história, identidade visual, verificação de números e 3 prioridades de melhoria.

Referências de leitura sob demanda

• references/direcao-visual.md: identidade, cenas e design cinematográfico.
• references/script-and-retention.md: estruturas narrativas e ganchos.
• references/precision-finance.md: cálculos e cuidados para casos do Peru.
• references/quality-control.md: rubrica e testes antes de publicar.
• examples/reel-depa-306k.md: exemplo completo de história e cenas.
• assets/storyboard-template.json: estrutura de dados do roteiro de produção.
• assets/style-tokens.json: tokens visuais iniciais, editáveis.