// 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 = { interactive: "doc/roteiro/ficcao.md", linear: "doc/roteiro/ficcao.md", documentary: "doc/roteiro/documental.md", }; const FORMAT_LABEL: Record = { 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 = { 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 --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": "", "logline": ""}.`, 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": "", "logline": ""}.`, 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//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//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/-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}": ""`).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}- --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"); }