# 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](ficcao.md) | | `linear` — ficção em sequência, sem votação | [ficcao.md](ficcao.md) | | `documentary` — vídeo único sobre fatos reais | [documental.md](documental.md) | O formato vem no pedido. Se não vier, está na primeira linha de `stories//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//` (bíblia e episódios anteriores), se existir. Mantenha continuidade de nomes, fatos, tom e consequências. - Escreva **somente** dentro de `stories//`: - `biblia.md` — primeira linha `Formato: `; o resto segue o guia do formato; - `.md` (ex.: `ep01.md`, `ep02-b.md`) — roteiro, no formato do guia; - `meta.json` — quando o pedido mandar: `{"title": "", "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.