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>
This commit is contained in:
@@ -0,0 +1,68 @@
|
||||
# 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.
|
||||
@@ -0,0 +1,72 @@
|
||||
# Guia de roteiro — documental (formato `documentary`)
|
||||
|
||||
Leia antes [comum.md](comum.md). Um **vídeo único**, vertical, sobre um tema real: um lugar, um
|
||||
fenômeno, um fato histórico, uma curiosidade. Não é série interativa nem ficção. As restrições de
|
||||
[ficcao.md](ficcao.md) **não valem** aqui.
|
||||
|
||||
## Regras
|
||||
|
||||
- **Nomes reais:** cite pelo nome cidades, estados, países, lugares, instituições, espécies e
|
||||
pessoas públicas. É isso que dá credibilidade ao vídeo.
|
||||
- **Fato com fonte:** confira cada afirmação em fonte confiável (instituição científica, órgão
|
||||
público, universidade, imprensa reconhecida) e liste as fontes no roteiro. Número incerto vira
|
||||
"estima-se" ou sai. Fonte que discorda de outra: diga que há divergência.
|
||||
- **Mito × fato:** se o tema tem lenda famosa, conte a lenda como lenda e mostre o que se sabe.
|
||||
- **Sem sensacionalismo** que contrarie as fontes. Pessoas privadas não são citadas pelo nome.
|
||||
- **Duração:** 45–90 s de narração (110–220 palavras), salvo se o pedido indicar outra.
|
||||
- **Narração por trecho:** cada linha da tabela é um parágrafo curto (1 a 2 frases, até ~35
|
||||
palavras). O painel gera um áudio por trecho; parágrafo longo deixa a voz sintética estranha.
|
||||
- **Números na narração por extenso:** "cinco", "trinta e cinco quilômetros", "onze mil anos",
|
||||
"cinquenta e cinco por hectare". A voz lê melhor. Na coluna **Texto na tela**, use algarismos
|
||||
("35 km de Itanhaém"), que é o que o público lê rápido. O painel ainda converte o que escapar.
|
||||
- **Ritmo:** gancho forte nos 2 primeiros segundos; um fato surpreendente a cada 10–15 s; fecho com
|
||||
convite a seguir ou comentar. Sem votação, sem opções A/B.
|
||||
|
||||
## `biblia.md` — ficha de pauta
|
||||
|
||||
```markdown
|
||||
Formato: documental
|
||||
# <tema>
|
||||
## Ângulo (a pergunta que o vídeo responde)
|
||||
## Público e tom
|
||||
## Fatos confirmados
|
||||
| Fato | Fonte (instituição) | Link |
|
||||
## Mitos a desmentir (o que se diz × o que as fontes dizem)
|
||||
## Referências visuais (lugares, mapas, espécies, imagens de arquivo)
|
||||
```
|
||||
|
||||
## Como o vídeo é montado (painel → página do vídeo → Montagem)
|
||||
|
||||
Cada trecho vira um áudio próprio (voz escolhida, texto falado editável) e um visual escolhido
|
||||
pelo admin: **imagem** (com zoom lento), **clipe de vídeo**, **cena 3D do Godot** (vídeo já
|
||||
renderizado) ou **cartela de texto**; dá para misturar no mesmo vídeo. A coluna "Imagem / B-roll"
|
||||
é a orientação para escolher esse visual: descreva o que deve aparecer, de forma que dê para achar
|
||||
em banco livre (Wikimedia Commons, Pexels…) ou fotografar. Animação 2D no Godot ainda não existe.
|
||||
|
||||
## Vídeo todo em 3D (estilo "Tudo em 3D" da montagem)
|
||||
|
||||
Quando o pedido for um vídeo em 3D, cada trecho vira uma cena 3D do Godot (biblioteca em
|
||||
`godot/library/`, guia `doc/godot/cenas.md`), e fotos reais aparecem num **cartão** por cima.
|
||||
- Na coluna **Imagem / B-roll**, descreva a TOMADA 3D: lugar, personagem, ação e câmera
|
||||
(ex.: "Lancha balançando no mar agitado à noite, câmera baixa perto da água").
|
||||
- Quando uma foto real precisar aparecer, marque `[foto: termos de busca]`
|
||||
(ex.: `[foto: Bothrops insularis]`). Use nomes específicos: o nome científico ou o nome do lugar.
|
||||
- Personagem (pessoa real de notícia): descreva roupa, idade aproximada e ação. A cena 3D é
|
||||
estilizada e respeitosa, sem caricatura.
|
||||
- Liste em **Necessidades de produção** as cenas 3D que ainda não existem na biblioteca
|
||||
(ex.: "cena 3D: lancha naufragando perto da ilha à noite"). É a lista de trabalho do agente
|
||||
da tarefa "Cena no Godot".
|
||||
|
||||
## Formato do roteiro (`ep01.md`)
|
||||
|
||||
```markdown
|
||||
# <título do vídeo>
|
||||
Duração alvo: <N> s · Formato: documental (vídeo único)
|
||||
|
||||
## Gancho (0–2 s)
|
||||
## Roteiro cena a cena
|
||||
| t (s) | Imagem / B-roll | Texto na tela | Narração |
|
||||
## Texto de capa / overlay.title (até 80 caracteres, ideal ≤ 30)
|
||||
## Fontes (título, instituição, link e o fato que cada uma sustenta)
|
||||
## Necessidades de produção (cenário, imagens, mapas, animações que a cena atual ainda não faz)
|
||||
```
|
||||
@@ -0,0 +1,47 @@
|
||||
# Guia de roteiro — ficção (formatos `interactive` e `linear`)
|
||||
|
||||
Leia antes [comum.md](comum.md). Histórias animadas curtas, publicadas um episódio por vez
|
||||
(~12 s cada). Na **interativa**, o público escolhe nos comentários o que acontece no próximo
|
||||
episódio. Na **linear**, os episódios seguem em sequência, sem votação.
|
||||
|
||||
## Restrições do produto (não negociáveis)
|
||||
|
||||
- Sem nomes de cidade, bairro real, clube, empresa ou marca. Use bairro fictício de aparência
|
||||
brasileira e apps e lojas com nomes inventados e genéricos.
|
||||
- Sem pessoas reais.
|
||||
- **Interativa:** cada episódio termina numa decisão clara entre ações concretas e diferentes
|
||||
(2 a 4 opções, conforme a história). Nada de opção "certa" óbvia: todas precisam ter custo e graça.
|
||||
- **Linear:** cada episódio termina num gancho para o próximo, sem escolha do público.
|
||||
- Episódio de série abre com recapitulação em 1 frase, para quem chegou agora.
|
||||
|
||||
## `biblia.md`
|
||||
|
||||
```markdown
|
||||
Formato: interativa | linear
|
||||
# <título>
|
||||
## Premissa
|
||||
## Personagens (nome, traço, objetivo)
|
||||
## Lugar
|
||||
## Tom
|
||||
## Regras do mundo
|
||||
## Arco previsto
|
||||
```
|
||||
|
||||
## Formato de `<file_key>.md`
|
||||
|
||||
```markdown
|
||||
# Episódio NN — <título interno>
|
||||
Duração alvo: 12 s · Escolha anterior: <letra e o que foi> (ou "início")
|
||||
|
||||
## Resumo (2–3 frases)
|
||||
## Cena a cena
|
||||
| t (s) | Imagem | Narração / diálogo |
|
||||
## Chamada final
|
||||
## Campos de overlay (copiar para o JSON)
|
||||
{"title": "...", "choiceA": "A — ...", "choiceB": "B — ..."}
|
||||
## Consequência de cada escolha (semente do próximo episódio)
|
||||
## Necessidades de produção (o que a cena atual ainda não faz)
|
||||
```
|
||||
|
||||
Na linear, os campos de overlay têm só `title`, e a seção de consequências vira "Gancho para o
|
||||
próximo episódio". As opções seguem o formato `A — <ação>`, `B — <ação>`.
|
||||
Reference in New Issue
Block a user