Files
CenaForge/doc/roteiro/comum.md
T
MateuusandClaude Opus 5.5 84f30bbc2d CenaForge: primeira versão pública
Gerador de vídeos narrativos (Godot + FFmpeg), painel Next.js, serviço de voz,
Clipador de lives e Publicador para YouTube, TikTok e Instagram.

Inclui a leitura das visualizações dos posts para o Dashboard e o botão
"Publicar no <rede>" nos cartões das publicações.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 16:35:09 -03:00

3.2 KiB
Raw Blame History

Guia de roteiro — regras comuns (todos os formatos)

Fonte única de regras de texto do CenaForge. Vale para qualquer IA que escreva roteiro: o Codex (pelo prompt do painel) e o subagente cenaforge-story-writer do Claude leem estes mesmos arquivos. Leia este e depois o guia do formato da história:

Formato (kind no painel) Guia
interactive — interativa, com votação ficcao.md
linear — ficção em sequência, sem votação ficcao.md
documentary — vídeo único sobre fatos reais documental.md

O formato vem no pedido. Se não vier, está na primeira linha de stories/<id>/biblia.md (Formato: interativa | linear | documental). Na dúvida, pergunte em vez de supor.

Idioma e tom

  • Português do Brasil, natural e falado, para público amplo.
  • Vídeo vertical (9:16), curto. Narração: ~2,5 palavras por segundo de cena.
  • Na narração (o que a voz fala), números por extenso ("cinco", não "5"); no texto na tela, algarismos. Parágrafos de narração curtos: o áudio é gerado trecho a trecho.
  • Sem violência gráfica, sexo ou discurso de ódio. Tensão, humor e curiosidade, sim.

Onde ler e onde escrever

  • Antes de escrever, leia stories/<id>/ (bíblia e episódios anteriores), se existir. Mantenha continuidade de nomes, fatos, tom e consequências.
  • Escreva somente dentro de stories/<id>/:
    • biblia.md — primeira linha Formato: <formato>; o resto segue o guia do formato;
    • <file_key>.md (ex.: ep01.md, ep02-b.md) — roteiro, no formato do guia;
    • meta.json — quando o pedido mandar: {"title": "<até 60 caracteres>", "logline": "<1–2 frases>"}.
  • Nunca edite config/, godot/, scripts/, panel/, .claude/ nem a documentação do projeto. Não crie cena JSON nem renderize numa tarefa de roteiro.

Estrutura de vídeo curto

Bloco Função
Gancho (0–2 s) imagem forte + texto na tela: afirmação, pergunta ou ação já em andamento
Contexto o mínimo para entender o que está em jogo
Escalada cada beat aumenta tensão, graça ou surpresa; troca visual a cada 2–4 s
Pagamento a resposta, o susto, a risada — ou a escolha (interativa)

Nunca prometa no gancho o que o vídeo não entrega.

Limites de texto do contrato JSON (conte os caracteres)

Campo Limite
overlay.title 1–80 caracteres, uma frase curta; ideal ≤ 30 para caber em 2 linhas
overlay.choiceA / choiceB 1–48 caracteres (só ficção interativa); ideal ≤ 24
quebra de linha, tabulação proibidas nesses campos

Produção

A cena atual do projeto é limitada (rua com o entregador de moto: andar, frear, parar). Tudo que o roteiro pedir além disso (outro cenário, personagem, mapa, foto, animação, boca mexendo) vai na seção Necessidades de produção, em vez de fingir que já existe.

Economia

Seja direto: não reescreva a bíblia inteira a cada episódio, só acrescente o que mudou. Não leia arquivos fora de stories/ e de doc/roteiro/ a menos que o pedido cite um.

Retorno

Responda em poucas linhas: arquivos escritos, o bloco de overlay (com a contagem de caracteres de cada campo), as fontes (documental) e as necessidades de produção.