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

69 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/<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.