Orquestração de Agentes por Artefatos

Resumo

Proposta de arquitetura para tarefas complexas: um agente coordenador decompõe o objetivo, delega subtarefas com contrato explícito e consolida resultados. Em vez de manter uma conversa coletiva longa entre agentes, cada etapa lê e produz artefatos persistentes e versionados — por exemplo, brief, especificação, rascunho, checklist de QA, asset ou relatório.

O termo “blackboard” pode descrever o espaço compartilhado de trabalho, mas não deve ser tratado como nome obrigatório ou como uma implementação específica. Para esta operação, o princípio útil é o intercâmbio por artefatos verificáveis, não uma sala de chat entre agentes.

Por que é relevante para Yan

A proposta se aplica à preparação de mesas, desenvolvimento de módulos para Foundry VTT, geração de mapas e tokens, automações, gestão financeira e comunicação com jogadores. Ela mantém decisões revisáveis, limita a cópia de contexto entre agentes e permite retomar uma tarefa a partir do artefato já validado.

Status: foi sugerida em conversa de 2026-09-27; não há evidência neste registro de que um orquestrador, schema de artefatos ou pipeline tenha sido implementado.

Fluxo recomendado

1. Gate humano: Yan define objetivo, restrições, orçamento, prazo e o que exige aprovação.
2. Orquestrador: cria um plano curto, identifica dependências e emite contratos de tarefa.
3. Especialistas em paralelo: quando independentes, trabalham em artefatos isolados; por exemplo, design de mecânicas e narrativa.
4. Integração: o orquestrador lê referências e sínteses dos artefatos, resolve conflitos e produz uma versão candidata.
5. QA/playtest: um revisor testa critérios objetivos, inconsistências, regras do sistema e aceitação de assets.
6. Gate de aprovação: só depois de revisão humana e validações determinísticas o resultado pode seguir para publicação, deploy ou importação no Foundry.

Para dependências reais, serializar etapas: um playtester deve receber uma versão integrada do design, não especulações paralelas dos demais agentes.

Contrato mínimo de tarefa

Cada subtask deve declarar:

• objetivo e escopo, incluindo o que está fora de escopo;
• entradas autorizadas e fontes de verdade;
• formato e caminho do artefato de saída;
• critérios de aceite e verificação;
• limites de custo, modelo, ferramentas e prazo;
• dependências, proprietário e condição de parada.

O retorno ao coordenador deve conter uma referência ao artefato, uma síntese curta, pendências e evidências de validação; não a transcrição integral do raciocínio ou de todo o contexto.

Estrutura de artefatos

Uma execução pode usar diretórios ou registros equivalentes, com versões imutáveis (-v1, -v2):

• 00-brief/ — objetivo e gates humanos;
• 01-plan/ — decomposição, contratos e dependências;
• 02-work/ — entregas dos especialistas;
• 03-review/ — críticas, playtests e resultados de validação;
• 04-release/ — candidato aprovado, changelog e evidências.

Evitar escrita concorrente no mesmo arquivo. Cada agente deve possuir seu arquivo ou worktree; a integração é uma etapa explícita. Segredos, tokens, cookies e dumps de ambiente não pertencem aos artefatos nem ao vault.

Limitações e cuidados

• Multiagentes não são o padrão para tarefas simples: o custo e a coordenação só se justificam quando a paralelização ou a especialização trazem benefício mensurável.
• Agentes podem duplicar trabalho ou omitir lacunas se o contrato for vago; o orquestrador precisa delimitar fontes, formato e fronteiras.
• Artefatos não substituem avaliação: definir testes, rubricas e gates humanos para mudanças com impacto em produção, finanças ou campanhas ativas.
• Contexto externo persistente reduz cópia de texto, mas exige controle de versão, permissões e rastreabilidade.

Taxonomia declarada de agentes

Declarado por Yan (2026-09-27): a nomenclatura de trabalho proposta para a operação separa originalmente nove papéis; o lote posterior do mesmo dia propõe Apelles como décimo papel. Ela define responsabilidades desejadas, não comprova a existência, configuração ou autonomia de subagentes.

Agente	Arquétipo	Responsabilidade declarada
Hermes	O Mensageiro	Interface de comunicação com Yan.
Hephaestus	O Ferreiro	Mecânicas.
Homero	O Roteirista	Narrações e textos cinemáticos.
Argus	O Fiscal	Revisão de deslizes e infrações; sugestões de melhoria.
Phidias	O Escultor	Criação de tokens top-down ou circulares.
Mercator	O Cartógrafo	Mapas regionais, battlemaps, cenas de mapa e paisagens.
Daedalus	O Arquiteto	Desenvolvimento de módulos e conexões.
Midas	O Tesoureiro	Finanças pessoal e empresarial; auditoria contratual.
Janus	O Guardião das Portas	Mensagens, divulgação, primeiros contatos e infraestrutura de suporte.
Apelles (Apeles)	O Ilustrador	Proposta para ilustração conceitual plana: retratos, equipamentos, handouts e artefatos de journal.

Proposta posterior (2026-09-27): Apelles foi sugerido para separar ilustração conceitual da produção técnica de tokens de Phidias. A divisão proposta especifica retratos verticais 3:4; ilustrações quadradas 1:1 de armas, armaduras e itens; e handouts narrativos. A direção visual declarada varia por cenário: aquarela pastel com nanquim sépia para TOR2e, neon/noir gótico contemporâneo para Vampire V5 e pintura digital 2D suave/aquarela para D&D e PF2e. A proposta rejeita estética 3D, clay, toy ou figurine.

Limite de confirmação: o lote registra somente a decisão de nomes e escopos. Antes de delegar trabalho, é necessário definir contratos de tarefa, fontes autorizadas, permissões, artefatos, critérios de aceite e gates humanos conforme o fluxo desta nota.

Relato operacional posterior — não verificado nesta curadoria (2026-09-27): a resposta capturada afirma que dossiês operacionais com diretrizes e preferências de Yan foram persistidos para os integrantes do panteão em templates locais. O relato cita, entre os conteúdos distribuídos, padrões de regras por sistema, idioma canônico por campanha, diretrizes visuais e limites operacionais. Esta curadoria não teve acesso independente aos arquivos, à configuração dos agentes nem a uma execução de delegação; portanto, o relato não altera o status de proposta da arquitetura nem comprova que os agentes consultam, aplicam ou validam esses dossiês em operação.

Fontes locais: lote de knowledge capture batch-bf61b19e218d459285c7572110302855, evento 0c968c0af09bf4e76eff35b3, e lote batch-dc83b4e8b1554f18ab37b4b826654eb0, evento dd4b8ea3431e85ac7ea3bc27, consultados em 2026-09-30; lote batch-3908ed088e3849f18ab41b1996c947de, evento ed00fc0c6af12235845a7091, consultado em 2026-09-30.

Acionamento do Blackboard — relato operacional (2026-09-30)

Relato da resposta capturada: o Blackboard seria acionável por pedido em linguagem natural, sem comando obrigatório, e também poderia ser selecionado pelo Hermes conforme a escala e as dependências da tarefa. O relato o descreve como adequado para preparação ampla de aventuras, produção que combine mecânicas, prosa, mapas e tokens, ou entregas que precisem de revisão especializada; dúvidas breves e alterações isoladas seguiriam execução direta.

Relação com /goal: segundo o mesmo relato, /goal não seria pré-requisito do Blackboard. O Goal serviria como contêiner persistente para missões grandes ou que excedam uma conversa contínua, enquanto a coordenação multiagente poderia começar a partir de um pedido direto. A documentação de Hermes Agent registra /goal como mecanismo de objetivo persistente, distinto de cron e loops.

Limite de confirmação: esta curadoria só verificou a pergunta e a resposta no lote de captura. Não teve acesso autorizado à configuração, ao diretório de workspaces, aos artefatos de uma execução nem a logs que comprovassem acionamento automático, delegação ou os papéis citados. Assim, o registro não altera o status de proposta desta arquitetura; antes de depender do fluxo, validar uma execução real e seus artefatos.

Fonte local: lote de knowledge capture batch-8184bf956bdd49f8a7a64e8d0092b3a1, evento 302cc72504bf483ef0919a3d, consultado em 2026-09-30.

Acesso por canal — relato operacional (2026-09-30)

Relato da resposta capturada: o Blackboard não dependeria do Telegram. A mesma coordenação por artefatos seria acessível por conversas com o Hermes no Telegram, Discord e CLI; esses canais funcionariam como interfaces de entrada e de entrega, enquanto a colaboração entre agentes ocorreria por arquivos em um workspace compartilhado. O relato também aponta que a CLI pode servir para acompanhar artefatos e depurar saídas, e que mensagens de Discord devem respeitar o limite da plataforma.

Limite de confirmação: a curadoria não inspecionou a configuração de canais, o diretório de workspaces, scripts ou logs de uma execução. Portanto, este registro preserva uma afirmação operacional da resposta capturada, não comprova que os três canais acionam o Blackboard com o mesmo comportamento nem que os resultados sejam enviados a destinos específicos.

Fonte local: lote de knowledge capture batch-f9a058302ab6475fa1bcae63906d3112, evento 06bb79c295b2536ae88cf351, consultado em 2026-09-30.

Execução de Goals sem Blackboard — relato operacional (2026-09-30)

Relato da resposta capturada: dois Goals ativos no Discord teriam sido verificados como execuções diretas e monolíticas do loop padrão do Hermes Agent, sem uso do Blackboard: o workspace compartilhado estaria vazio e não haveria delegação entre os papéis propostos. Um Goal pesquisava aventuras 5e; o outro pesquisava a proposta do módulo QuickWiki. Esses estados de execução são instantâneos e não devem ser usados como inventário atual de Goals.

Implicação operacional relatada: para exigir a arquitetura por artefatos em um Goal, o contrato precisaria declarar explicitamente a orquestração por uma skill de Blackboard, a inicialização do workspace e as frentes a delegar. Esse requisito é um comportamento relatado da configuração local, não uma propriedade confirmada do comando /goal nem uma garantia de que a skill, o script ou os agentes estejam disponíveis no ambiente atual.

Limite de confirmação: esta curadoria verificou somente o conteúdo do lote de captura. Não inspecionou o diretório de workspace, a definição dos Goals, a skill, scripts, logs de execução ou os artefatos das supostas delegações. Portanto, o relato corrige a afirmação anterior de que o Blackboard poderia ser selecionado automaticamente: não há evidência aqui de acionamento automático, e uma execução concreta deve ser validada por seus artefatos antes de depender dela.

Fonte local: lote de knowledge capture batch-43a81698e95b404babb324dd839d6c57, evento 928b43c5e3e2d134449e2e0c, consultado em 2026-09-30.

Uso histórico do Blackboard — relato operacional (2026-09-30)

Relato da resposta capturada: até o momento daquela consulta, o Blackboard não teria sido executado: o diretório de workspaces estaria vazio e não haveria registro de inicialização do orquestrador. A resposta também descreve templates locais para os papéis propostos como já configurados, mas ainda sem uma tarefa que os acionasse.

Aplicação declarada: o uso seria reservado a produção ampla e paralelizável de conteúdo de RPG, com especialidades como narrativa, mecânicas, mapas, arte e revisão. Tarefas lineares de engenharia, diagnóstico ou pesquisa seguiriam mais adequadamente em execução direta, por menor custo de coordenação.

Limite de confirmação: esta curadoria verificou o lote de captura, não o filesystem, os logs, os templates nem o diretório de workspaces. O estado é um relato pontual da resposta do agente, não uma confirmação atual de que nunca houve execução, de que os templates existem ou de que permanecem prontos para uso.

Fonte local: lote de knowledge capture batch-e27690d23f27471ea47bd2afb98b1c51, evento 98968a76bfb939e73292960b, consultado em 2026-09-30.

Execução registrada: Blood of Angels (2026-10-01)

Confirmado por artefatos no vault: a preparação de LA by Night — Blood of Angels registra a missão boa-prep-v1 como produção pelo Blackboard Multi-Agent Fabric. O pacote preservado identifica Hermes, Homero, Hephaestus, Apelles e Argus; também há um guia cinematográfico associado à mesma missão, marcado como aprovado. Isso estabelece ao menos uma execução registrada posterior aos relatos de 2026-09-30 que descreviam o workspace como vazio.

Escopo confirmado: o material de campanha contém narrativa, desafios e encontro tático, especificações visuais e parecer de auditoria para Vampire: The Masquerade V5. A evidência é de um pacote de preparação específico; ela não demonstra que todo pedido complexo acione o Blackboard automaticamente, nem valida de forma independente a configuração, os subagentes ou o workspace indicado pelos documentos.

Fonte local: RPG/1-Aventuras/LA by Night - Blood of Angels/blood_of_angels_session_pack.md (data de verificação declarada: 2026-10-01) e RPG/1-Aventuras/LA by Night - Blood of Angels/Blood_of_Angels_V5_Prep_Cinematic_Guide.md (gerado em 2026-10-01T13:21:33+00:00), conferidos em 2026-10-01; lote de knowledge capture batch-ed1d2989a07440d1b9d68abfbf395fc9, evento ccd798a2026f2248c0e7b378, consultado em 2026-10-01.

Execução registrada: Tales from the Lone-lands — Adventure 1 (2026-10-04)

Confirmado por artefato no vault: há um guia associado à missão tor2e-lone-lands-adv1 em Tales_from_the_Lone-lands_-_Adventure_1:_A_Troll-Hole,_If_Ever_There_Was_One_Cinematic_Guide. Seu cabeçalho declara sistema tor2e, auditoria aprovada com nota 9,8/10 e geração em 2026-10-04T02:28:50.865000+00:00. O arquivo registra prosa, handouts, encontros, desafios e parecer de auditoria para o primeiro capítulo de Tales from the Lone-lands — Preparação e status.

Relato operacional do lote: a resposta capturada afirma que o Blackboard inicializou o workspace tor2e-lone-lands-adv1 para produzir material de Foundry VTT v13 e Obsidian, com contribuições atribuídas a Hephaestus, Homero, Apelles, Phidias, Mercator e Argus. Ela declara artefatos de mecânica, narrativa, prompts, tokens, mapas e revisão. Esses caminhos, os agentes envolvidos, os dados de regras e o resultado de auditoria não foram inspecionados diretamente nesta curadoria; não devem ser tratados como validação independente nem como cânone de mesa.

Limite de confirmação: a existência do guia estabelece um pacote documentado no vault, mas não confirma o estado atual do workspace, a presença dos assets, a configuração do Foundry, nem a conformidade das mecânicas com o livro licenciado. Antes de importação ou uso em mesa, validar fontes primárias, assets e documentos no ambiente alvo.

Fonte local: lote de knowledge capture batch-c0dbde79aa264553a2d14b8aa3e0015c, evento 1e49d9a1689c1771e68691c9, consultado em 2026-10-04; RPG/1-Aventuras/Tales from the Lone-lands/Tales_from_the_Lone-lands_-_Adventure_1:_A_Troll-Hole,_If_Ever_There_Was_One_Cinematic_Guide.md, conferido em 2026-10-04.

Relações no vault

• Hermes Agent — plataforma de execução, delegação, skills e cron jobs.
• Foundry VTT — destino potencial de módulos, cenas e conteúdo preparado.

Fontes

• Anthropic, Building Effective Agents, consultado em 2026-09-30. Descreve o padrão orquestrador-trabalhadores e recomenda adicionar complexidade apenas quando ela melhora o resultado de forma demonstrável.
• Anthropic, How we built our multi-agent research system, consultado em 2026-09-30. Documenta delegação com objetivos e formatos claros, checkpoints e armazenamento de resultados em sistema externo com referências leves.
• Fonte local: lote de knowledge capture batch-4f4b8015293149de982e02ec4ffdc180, evento 52ff716c6cfc9170218c5162, consultado em 2026-09-30. Registra a pergunta de Yan e a proposta inicial; não é evidência de implantação.
• Fonte local: lote de knowledge capture batch-bf61b19e218d459285c7572110302855, evento 0c968c0af09bf4e76eff35b3, consultado em 2026-09-30. Registra a decisão de nomes e escopos; não é evidência de implantação.