Files
CenaForge/panel/src/lib/prompts.ts
T
MateuusandClaude Opus 5.5 0050cf60a7 Estilo Cartoon (Remotion), personagens reaproveitáveis e hashtags do TikTok
Estilo Cartoon (novo, sem Godot)
- Pacote cartoon/ (Remotion 4.0.535): cada trecho é um spec JSON desenhado
  em React/SVG e renderizado em MP4; render em lote (empacota uma vez) e
  imagem parada (--still).
- Cenas montadas por peças, sem cenário pronto: paletas (noite, sépia, dia,
  entardecer, cinza), lugar com chão, interno/externo, névoa e 24 peças
  posicionadas por profundidade, foco de luz e vinheta; etiquetas,
  onomatopeias, ondas de som, X vermelho, painel do topo e legenda palavra
  por palavra.
- Montagem documental: "Cartoon" como estilo do vídeo e tipo de visual do
  trecho; plano por regras pelo texto (lugar, objetos, expressão, pose),
  tempos das palavras pela transcrição do áudio, "Gerar de novo" por trecho,
  paleta da série e elenco da história.

Personagens
- Aba Personagens: criar pela descrição, ajustar peça por peça com prévia
  ao vivo, refinar com o agente (tarefa nova "Personagem"); fichas em
  assets/characters/ e elenco em stories/<id>/cast.json. O mesmo personagem
  sai igual em qualquer cena, mudando expressão, pose e objeto na mão.

TikTok
- Hashtags passam a ser digitadas e confirmadas na lista de sugestões do
  TikTok Studio (coladas, viravam texto). Diagnóstico de alcance em
  doc/publicacao/TIKTOK_DIAGNOSTICO.md.

Docs: estudo das referências, doc/cartoon/ (personagens e cenas) e skill
cenaforge 1.46.0.

Testes: painel 77/77, cartoon 5/5, Publicador 87/87.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 21:36:48 -03:00

174 lines
14 KiB
TypeScript
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.
// Montagem do prompt enviado ao agente. O contexto (história, episódio, caminhos, escolha
// anterior) vem do banco; o texto do usuário entra como "Pedido". Comentários do público
// não entram.
import { childEpisodes, getEpisodeById } from "./stories";
import { BASE_SCENE, episodeChoicesPath, episodeConfigPath, episodeScriptPath, rel } from "./paths";
import type { AgentKind, EpisodeView, Provider, Story, StoryKind } from "./types";
/**
* Regras de roteiro: ficam em doc/roteiro/ (fonte única). O Codex lê os guias direto; o Claude
* delega ao subagente `cenaforge-story-writer`, que lê os mesmos guias. Assim os dois têm o
* mesmo contexto, e mudar uma regra é editar um .md, não este arquivo.
*/
const GUIDE_COMMON = "doc/roteiro/comum.md";
const GUIDE_BY_KIND: Record<StoryKind, string> = {
interactive: "doc/roteiro/ficcao.md",
linear: "doc/roteiro/ficcao.md",
documentary: "doc/roteiro/documental.md",
};
const FORMAT_LABEL: Record<StoryKind, string> = { interactive: "interativa", linear: "linear", documentary: "documental" };
/** Scripts sem LLM que substituem trabalho que o agente fazia lendo arquivos e imagens. */
const CHECK_FRAMES = "python .claude/skills/cenaforge/scripts/frame_check.py";
const CHECK_SCRIPT = "python .claude/skills/cenaforge/scripts/check_script.py";
/** Fecho das tarefas de texto: o script confere duração, narração por trecho e os JSON. */
function scriptCheck(storyId: string): string {
return `Antes de terminar, rode \`${CHECK_SCRIPT} stories/${storyId}\` e corrija os avisos (duração alvo, narração por trecho, meta.json, choices.json). Não reconte palavras à mão.`;
}
/** Pesquisa web do documental: as páginas abertas inteiras eram o que mais pesava no roteiro. */
const RESEARCH_ECONOMY = "Na pesquisa, busque o termo dentro da página em vez de abri-la inteira e pare em 3–5 fontes confiáveis que cubram os fatos do roteiro.";
function writingRules(provider: Provider, kind: StoryKind): string {
const guides = `\`${GUIDE_COMMON}\` e \`${GUIDE_BY_KIND[kind]}\``;
const core = kind === "documentary"
? "Formato DOCUMENTAL: vídeo único sobre fatos reais. Cidades, lugares e instituições reais pelo nome, cada fato com fonte; sem votação. As restrições de ficção não valem."
: `Formato ${FORMAT_LABEL[kind].toUpperCase()} (ficção): sem cidades, marcas nem pessoas reais.`;
return provider === "claude"
? `${core}\nPara o texto, use o subagente \`cenaforge-story-writer\` e diga a ele o formato (${FORMAT_LABEL[kind]}). Ele segue ${guides}.`
: `${core}\nLeia ${guides} e siga-os: são as regras e os formatos de arquivo. Escreva você mesmo; ` +
"não use `.claude/agents/` (subagentes do Claude, que leem esses mesmos guias).";
}
export function buildPrompt(input: { kind: AgentKind; provider: Provider; request: string; story?: Story; episode?: EpisodeView }): string {
const { kind, provider, request, story, episode } = input;
const documentary = story?.kind === "documentary";
// Economia de tokens: cada tarefa recebe só a lista curta do que ler. A skill inteira (SKILL.md +
// references, ~1.500 linhas) só entra nas tarefas que mexem no pipeline de render (cena, livre).
const reading: Record<AgentKind, string> = {
story: "Leia SÓ: `doc/roteiro/comum.md` e o guia do formato (`doc/roteiro/ficcao.md` ou `doc/roteiro/documental.md`). Não carregue a skill `cenaforge` nem `.claude/skills/`.",
script: "Leia SÓ: `doc/roteiro/comum.md`, o guia do formato e a pasta da história. Não carregue a skill `cenaforge` nem `.claude/skills/`.",
branches: "Leia SÓ: `doc/roteiro/comum.md`, `doc/roteiro/ficcao.md` e a pasta da história; para a cena, use o script `new_scene.py` indicado abaixo. Não carregue a skill inteira.",
godot: "Leia SÓ: `doc/godot/cenas.md` e `doc/godot/api.md` (assinaturas das peças e cenas; NÃO leia os .gd inteiros de outras cenas). Não carregue a skill `cenaforge`.",
scene: "Siga a skill `cenaforge` (.claude/skills/cenaforge/SKILL.md): leia só as seções que a tarefa pedir.",
character: "Leia SÓ: `doc/cartoon/personagens.md`. Não carregue a skill `cenaforge`.",
free: "Siga o CLAUDE.md; consulte a skill `cenaforge` (.claude/skills/cenaforge/SKILL.md) só no que a tarefa pedir.",
};
const lines: (string | null)[] = [
"Você está trabalhando no repositório CenaForge (vídeos narrativos: cena descrita por JSON → Godot → MP4).",
"Responda em português do Brasil.",
reading[kind],
"Trabalhe só dentro do repositório. Seja econômico: Grep antes de ler, leia por intervalo de linhas, filtre saídas longas (`| Select-Object -Last 20` / `| tail -n 20`). " +
"Não acione os subagentes `cenaforge-skill-updater` nem `cenaforge-token-auditor` (100–150 mil tokens cada): isso é feito fora do painel. " +
"Ao terminar, liste os arquivos criados ou alterados e o que ficou pendente.",
provider === "codex"
? "Você é o Codex. Arquivos em `.claude/agents/` são subagentes do Claude: você não os aciona; quando o CLAUDE.md mandar delegar a um deles, faça o trabalho você mesmo. " +
"No PowerShell, leia texto com `Get-Content -Raw -Encoding UTF8` (sem isso os acentos saem quebrados) e rode o pnpm como `pnpm.cmd` " +
"(o `pnpm.ps1` é bloqueado pela política de execução): `pnpm.cmd render -- --config <json> --profile preview`."
: null,
];
if (story) {
const format = story.kind === "interactive"
? `interativa: cada episódio termina numa escolha do público entre ${story.branch_count} vertentes`
: documentary ? "documental: vídeo único sobre fatos reais, sem votação" : "linear";
lines.push("", "## Contexto",
`História: ${story.title} (id \`${story.id}\`, ${format}).`,
story.logline ? `Premissa: ${story.logline}` : "Premissa: ainda não definida.",
`Pasta da história: \`stories/${story.id}/\` (bíblia, episódios e assets exclusivos em \`stories/${story.id}/assets/\`). Biblioteca compartilhada: \`assets/library/\`.`);
}
if (story && episode) {
lines.push(`Episódio ${episode.number} (\`${episode.file_key}\`)${episode.title ? ` — ${episode.title}` : ""}.`,
`Roteiro: \`${episode.scriptPath}\` (${episode.hasScript ? "existe" : "ainda não existe"}).`,
`Cena: \`${episode.configPath}\` (${episode.hasConfig ? "existe" : "ainda não existe"}).`);
if (episode.parent_episode_id && episode.parent_choice) {
const parent = getEpisodeById(episode.parent_episode_id);
const label = episode.branch_label || parent?.choices.find((c) => c.letter === episode.parent_choice)?.label || null;
lines.push(`Escolha do público no episódio anterior: ${episode.parent_choice}${label ? ` ("${label}")` : ""}. O episódio precisa seguir essa consequência.`);
}
}
if (kind === "story" && story && documentary) {
const ep = episode ? episode.scriptPath : `stories/${story.id}/ep01.md`;
lines.push("", "## Tarefa: montar o vídeo documental a partir do texto do usuário",
"O texto em \"Pedido\" é o tema escolhido pelo criador. Pesquise na web, confira os fatos e escreva o vídeo.",
RESEARCH_ECONOMY,
writingRules(provider, story.kind),
`1. Escreva a ficha de pauta em \`stories/${story.id}/biblia.md\`.`,
`2. Escreva o roteiro do vídeo em \`${ep}\`.`,
`3. Grave \`stories/${story.id}/meta.json\` exatamente assim: {"title": "<título final, até 60 caracteres>", "logline": "<o vídeo em 1–2 frases>"}.`,
scriptCheck(story.id),
"Não crie cena JSON, não renderize e não altere código. Ao terminar, resuma o vídeo, liste as fontes usadas e as necessidades de produção.");
} else if (kind === "story" && story) {
const ep = episode ? episode.scriptPath : `stories/${story.id}/ep01.md`;
lines.push("", "## Tarefa: montar a história a partir do texto do usuário",
"O texto em \"Pedido\" é o material de partida do criador (ideia, sinopse ou rascunho). Transforme-o numa história do formato CenaForge:",
"episódios verticais curtos (~12 s), um de cada vez, " + (story.kind === "interactive" ? "cada um terminando numa escolha A/B do público." : "sem escolha do público."),
writingRules(provider, story.kind),
`1. Escreva a bíblia em \`stories/${story.id}/biblia.md\`.`,
`2. Escreva o primeiro episódio em \`${ep}\`.`,
`3. Grave \`stories/${story.id}/meta.json\` exatamente assim: {"title": "<título final, até 60 caracteres>", "logline": "<premissa em 1–2 frases>"}.`,
scriptCheck(story.id),
"Não crie cena JSON, não renderize e não altere código. Ao terminar, resuma a história e liste as necessidades de produção.");
} else if (kind === "script") {
lines.push("", "## Tarefa: roteiro",
story ? writingRules(provider, story.kind) : null,
story ? `Crie a ${documentary ? "ficha de pauta" : "bíblia"} \`stories/${story.id}/biblia.md\` se não existir.` : "Peça a história antes de escrever.",
episode ? `Escreva \`${episode.scriptPath}\`.` : null,
story && documentary ? RESEARCH_ECONOMY : null,
story ? scriptCheck(story.id) : null,
"Não crie cena JSON nem renderize nesta tarefa.");
} else if (kind === "character") {
lines.push("", "## Tarefa: personagem do estilo Cartoon (biblioteca de personagens)",
"O pedido traz o id e a descrição de um personagem. Monte a aparência por peças conforme `doc/cartoon/personagens.md` e grave a ficha.",
"1. Leia `assets/characters/<id>/character.json` se existir (o painel cria um rascunho pelas regras); mantenha id, name e createdAt.",
"2. Ajuste `look` (só os valores da tabela do guia; cores #rrggbb), `caption` curta (função · idade) e `description`.",
"3. Escreva o arquivo com JSON válido. Não crie imagens, não renderize e não altere `cartoon/` nem `panel/`.",
"Ao terminar: diga em 3 linhas o que escolheu e por quê (a marca que deixa o personagem reconhecível).");
} else if (kind === "godot") {
lines.push("", "## Tarefa: construir uma cena no Godot (biblioteca de cenas)",
"O pedido descreve uma cena (lugar, objeto, personagem, animação). Construa-a no Godot e guarde na biblioteca, para este e para os próximos vídeos.",
"Siga `doc/godot/cenas.md` (contrato, manifesto, teste e checklist). As peças e cenas prontas estão resumidas em `doc/godot/api.md`: use as funções de lá sem abrir os .gd inteiros.",
"1. Liste `godot/library/` e leia só os manifest.json: reaproveite cenas e peças (`godot/kits/`) em vez de refazer.",
"2. Crie ou estenda `godot/library/<id>/template.gd` e `manifest.json` (id em minúsculas com hífens). Peças reaproveitáveis em .gd separados na mesma pasta.",
`3. Teste com \`${CHECK_FRAMES} --config data/tmp/<id>-teste.json\`: ele renderiza o preview e devolve ~10 linhas (status, tempo, luz, contraste, movimento e enquadramento de cada quadro). ` +
"Corrija até passar no checklist do guia, inclusive variant 0, 1 e 2 e cada opção dos parâmetros. " +
"IMAGENS: no máximo UMA por render, a que o script indicar (folha de 480 px ou o quadro marcado). Não abra quadros soltos em resolução cheia, não abra imagens em lote " +
"e não gere imagens próprias de QA: cada imagem fica no histórico e é reenviada a todo turno. Não entregue sem olhar ao menos uma folha.",
"4. Não altere `godot/scripts/`, `scripts/` nem `panel/`: a cena aparece sozinha no painel (formulário e escolha automática pelas palavras-chave).",
story ? `Contexto: a cena é para o vídeo "${story.title}". Leia \`stories/${story.id}/\` (roteiro: coluna Imagem de cada trecho) para acertar o que a cena precisa mostrar.` : null,
"Ao terminar: rode `python .claude/skills/cenaforge/scripts/godot_api.py` (atualiza o resumo doc/godot/api.md), apague os JSON de teste de data/tmp/ e informe o id da cena, o que cada parâmetro faz e o tempo de render.");
} else if (kind === "scene") {
lines.push("", "## Tarefa: cena",
episode
? `Crie \`${episode.configPath}\` a partir do roteiro \`${episode.scriptPath}\`, usando ` +
`\`python .claude/skills/cenaforge/scripts/new_scene.py --id ${story!.id}-${episode.file_key} --base ${BASE_SCENE}\` ` +
"com --set para overlay (title, choiceA, choiceB) e o que o roteiro pedir dentro do contrato. Use seed diferente por episódio."
: "Escolha um episódio antes de montar a cena.",
"Valide (o script já valida). Não renderize: o render é disparado pelo painel. Se o roteiro pedir algo que o contrato não suporta, liste em 'pendências'.");
}
if (kind === "branches" && story && episode) {
const children = childEpisodes(episode.id);
const letters = children.map((c) => c.parent_choice).join(", ");
lines.push("", `## Tarefa: preparar as ${children.length} vertentes do episódio \`${episode.file_key}\` (só o próximo nível)`,
`O episódio \`${episode.scriptPath}\` termina numa decisão do público com ${children.length} opções (${letters}).`,
"Leia a bíblia da história e o roteiro deste episódio (e dos anteriores no caminho, se precisar de contexto).",
writingRules(provider, story.kind),
`1. Escreva as opções da decisão em \`${rel(episodeChoicesPath(story.id, episode.file_key))}\`, exatamente assim: ` +
`{${children.map((c) => `"${c.parent_choice}": "<texto curto da opção, até 60 caracteres>"`).join(", ")}}. ` +
"As opções precisam ser realmente diferentes entre si e levar a consequências distintas.",
"2. Para cada vertente, escreva o roteiro do episódio seguinte como consequência daquela escolha:",
...children.map((c) => ` - ${c.parent_choice}: \`${rel(episodeScriptPath(story.id, c.file_key))}\``),
" Cada roteiro termina na sua própria decisão para o público (o próximo nível será preparado depois).",
"3. Para cada vertente, crie a cena com " +
`\`python .claude/skills/cenaforge/scripts/new_scene.py --id ${story.id}-<file_key> --base ${BASE_SCENE}\` ` +
"(seed diferente em cada uma), gerando:",
...children.map((c) => ` - ${c.parent_choice}: \`${rel(episodeConfigPath(story.id, c.file_key))}\``),
`4. No overlay da cena deste episódio (\`${episode.configPath}\`), ajuste choiceA/choiceB para as opções A e B ` +
(children.length > 2 ? "(o render ainda só desenha duas opções na tela; C e D ficam no choices.json e no painel)." : "."),
scriptCheck(story.id),
"Não renderize, não gere áudio e não altere código. Ao terminar, liste as opções e os arquivos criados.");
}
lines.push("", "## Pedido", request);
return lines.filter((l): l is string => l !== null).join("\n");
}