# Dois agentes colaboram por uma fila Como uma demanda passa de um agente para outro sem presumir chamada direta entre projetos? Exemplo fictício · arquitetura proposta · nenhuma operação demonstrada · 0.1.0 · 2026-11-05 Registrar uma demanda e iniciar o trabalho do destinatário são operações distintas. Neste cenário, a pessoa inicia a sessão destinatária, que consulta a fila e devolve sua contribuição no mesmo registro. publico: Pessoa que configura ou utiliza um agente de IA. escopo: Cenário fictício: um agente registra uma necessidade e outro a consulta e devolve o resultado pela mesma fila. fora_do_escopo: Configuração de agendamento, gatilho por evento, chamada entre projetos, acesso de conta e implantação. ## O agente por dentro O que cada contribuição muda na revisão? Fronteira funcional: orientação, conhecimento, fontes, transformação, meios e continuidade. Arquivos guardados e conteúdo recebido são condições diferentes. Fronteira Contribuições funcionais ao trabalho · não representa uma pasta: Orientação de atuação, Conhecimento e critérios, Pauta e nota de origem, Agente de revisão, Transformação de revisão, Condição da revisão, Leitura e gravação - Orientação de atuação → orienta atuação → Agente de revisão (proposta · proposto; orienta). - Conhecimento e critérios → oferece critérios → Agente de revisão (proposta · proposto; criterios). - Pauta e nota de origem → fornece insumos → Agente de revisão (proposta · proposto; insumos). - Transformação de revisão → estrutura revisão → Agente de revisão (proposta · proposto; transforma). - Leitura e gravação → viabiliza operações → Agente de revisão (proposta · proposto; meios). - Condição da revisão → permite retomada → Agente de revisão (proposta · proposto; recupera). - Agente de revisão → preserva condição → Condição da revisão (proposta · proposto; preserva). ## O agente no sistema Como o trabalho é encaminhado, iniciado e devolvido? Há escrita e consulta da fila. A pessoa inicia a sessão do destinatário. Nenhuma seta liga diretamente os dois projetos. Fronteira Condição compartilhada: Fila compartilhada - Pessoa responsável → solicita revisão → Agente de revisão (proposta · proposto; solicita). - Agente de revisão → registra demanda → Fila compartilhada (proposta · proposto; encaminha). - Agente de revisão → recupera retorno → Fila compartilhada (proposta · proposto; recupera-retorno). - Pessoa responsável → inicia sessão → Agente de planejamento (proposta · proposto; inicia-parceiro). - Agente de planejamento → consulta demanda → Fila compartilhada (proposta · proposto; consulta-fila). - Agente de planejamento → devolve resultado → Fila compartilhada (proposta · proposto; retorno-fila). ## Componentes ### Pessoa responsável · pessoa tipo: pessoa papel: Apresenta o pedido e decide o uso da revisão. detalhe: Inicia as sessões de trabalho do cenário e decide efeitos fora da ordem da demanda. O desenho não configura uma agenda. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ### Agente de revisão · agente tipo: agente papel: Confronta afirmações e fontes para preparar uma revisão verificável. detalhe: Recebe pauta e nota, identifica divergência, explica a razão e entrega correção. A continuidade é necessária apenas se o trabalho precisar ser retomado. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ### Orientação de atuação · orientacao tipo: orientação papel: Distingue revisão de texto de decisão sobre o conteúdo. detalhe: Identidade e núcleo orientam a perceber o pedido, mobilizar fontes e concluir. Preparar uma pauta não significa aprovar seu conteúdo. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ### Conhecimento e critérios · inteligencia tipo: conhecimento papel: Distingue discussão prevista de decisão tomada. detalhe: Compara sentido e origem das afirmações. Uma nota que diz 'discutiremos' não sustenta uma pauta dizendo 'foi aprovado'. Ausência de fonte exige apontar a lacuna, sem completar a decisão. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ### Pauta e nota de origem · fontes-caso tipo: documento papel: Oferecem as afirmações do caso e sua sustentação. detalhe: A pauta fictícia diz que um lançamento foi aprovado; a nota de origem informa que ele será discutido. O conflito entre os textos é o insumo da revisão. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ### Transformação de revisão · skill tipo: Skill papel: Organiza comparação, correção e conferência do texto. detalhe: Recebe pauta e nota, liga cada diferença à fonte e produz versão revisada com justificativa. O método é ilustrativo; não declara uma Skill de revisão instalada. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ### Leitura e gravação · ferramenta tipo: ferramenta papel: Permite receber insumos e salvar o resultado. detalhe: É preciso demonstrar as operações nos arquivos da instância e no destino autorizado. O nome de uma ferramenta não comprova leitura, escrita ou conteúdo recebido. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ### Condição da revisão · continuidade tipo: registro papel: Guarda resultado válido e o que falta para retomar. detalhe: Preserva identidade do caso, edição dos documentos, resultado, lacuna e próximo movimento. Uma nova sessão precisa receber e ler esse registro. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ### Fila compartilhada · fila tipo: registro papel: Preserva identidade, pedido, condição e resultado de cada demanda. detalhe: Um registro por demanda, com destinatário, contexto, fontes, saída esperada, situação e retorno. Distingue item novo de item já tratado. Gravar o item não inicia outra sessão. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ### Agente de planejamento · parceiro tipo: agente papel: Consulta demandas endereçadas a ele e registra sua contribuição. detalhe: A pessoa inicia a sessão e disponibiliza sua orientação e o acesso à fila. O destinatário relê o item, executa sua contribuição autorizada e devolve resultado ou dependência no mesmo registro. arquitetura: proposta afirmacao: proposto evidencia: Definição do cenário fictício; sem teste de uso. fontes: fonte-cenario ## Relações e condições de operação ### orienta: Orientação de atuação → orienta atuação → Agente de revisão natureza: conhecimento arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Conteúdo recebido no início ou por leitura explícita. inicio: Pessoa inicia a sessão e disponibiliza orientação. autoridade: Orientação delimita revisão, sem conceder decisão de negócio. registro: Edição de orientação usada na demanda. falha: Se o texto não chegar, recuperar seu conteúdo antes da conclusão afetada. confirmacao: Conferir conteúdo efetivamente recebido e seu uso na revisão. fontes: fonte-cenario ### criterios: Conhecimento e critérios → oferece critérios → Agente de revisão natureza: conhecimento arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Leitura e aplicação do conhecimento pertinente. inicio: Diferença entre afirmações exige critério de decisão. autoridade: Interpretar a diferença no escopo da revisão solicitada. registro: Justificativa ligada à revisão. falha: Se faltar critério, explicitar a insuficiência em vez de aprovar por plausibilidade. confirmacao: A revisão explica por que discussão não sustenta aprovação. fontes: fonte-cenario ### insumos: Pauta e nota de origem → fornece insumos → Agente de revisão natureza: informacao arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Conteúdo dos documentos recebido pela sessão. inicio: Pedido de revisão com pauta e nota. autoridade: Leitura dos documentos fornecidos para aquela revisão. registro: Identidade e edição dos insumos na demanda. falha: Se a nota não puder ser lida, registrar ausência e não preencher decisão. confirmacao: Confrontar a revisão com os trechos do caso. fontes: fonte-cenario ### transforma: Transformação de revisão → estrutura revisão → Agente de revisão natureza: conhecimento arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Aplicação de procedimento reutilizável de comparação. inicio: Pedido reconhecido como revisão por confronto de fontes. autoridade: Produzir revisão e justificativa no escopo recebido. registro: Método e resultado na demanda. falha: Se uma etapa não bastar, voltar ao critério ou à fonte afetada. confirmacao: Correção, justificativa e referência permitem conferir o resultado. fontes: fonte-cenario ### meios: Leitura e gravação → viabiliza operações → Agente de revisão natureza: dependencia arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Leitura de insumos e gravação em destino autorizado, se disponíveis. inicio: Agente realiza as operações necessárias ao pedido. autoridade: Operações limitadas aos insumos e derivados autorizados. registro: Resultado salvo no destino escolhido para a demanda. falha: Se não houver escrita, preparar conteúdo e destino para aplicação assistida. confirmacao: Reler o arquivo salvo e confrontar seu conteúdo com o produzido. fontes: fonte-cenario ### recupera: Condição da revisão → permite retomada → Agente de revisão natureza: informacao arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Nova sessão lê a condição vinculada ao caso. inicio: Pessoa reabre o trabalho e fornece o registro. autoridade: Retomar o caso no alcance do pedido atual. registro: Condição vigente do caso. falha: Se a condição estiver desatualizada, reconciliar a fonte antes de usar. confirmacao: Outra sessão reconhece resultado válido e o próximo movimento. fontes: fonte-cenario ### preserva: Agente de revisão → preserva condição → Condição da revisão natureza: informacao arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Gravação em registro do caso; aplicação assistida se faltar escrita. inicio: Conclusão ou interrupção material da revisão. autoridade: Preservar contexto necessário à continuidade da revisão. registro: Registro do caso, com resultado e lacuna. falha: Se a gravação falhar, entregar a atualização pronta e não declarar persistência. confirmacao: Reler o registro no destino e conferir a edição. fontes: fonte-cenario ### solicita: Pessoa responsável → solicita revisão → Agente de revisão natureza: controle arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Conversa com os documentos do caso. inicio: Pedido explícito da pessoa. autoridade: Revisar documentos e produzir derivados; envio não incluído. registro: Demanda com pedido e insumos. falha: Se o objeto for ambíguo, esclarecer qual pauta antes de alterar. confirmacao: Pedido, documentos e destinatário concordam. fontes: fonte-cenario ### encaminha: Agente de revisão → registra demanda → Fila compartilhada natureza: informacao arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Escrita de item identificado no registro compartilhado ou aplicação assistida. inicio: Agente de revisão encontra necessidade de planejamento no alcance do pedido. autoridade: Preparar encaminhamento com resultado esperado; não iniciar outro projeto. registro: Um item com ID estável, destinatário, fontes e condição. falha: Se faltar escrita, preparar o item para aplicação e não anunciar recebimento. confirmacao: Reler o item no destino e conferir campos e identidade. fontes: fonte-cenario ### inicia-parceiro: Pessoa responsável → inicia sessão → Agente de planejamento natureza: controle arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Pessoa abre a sessão destinatária e fornece orientação e pedido para consultar a fila. inicio: Intervenção manual da pessoa; não é evento disparado pela fila. autoridade: Conduzir a contribuição do destinatário no alcance da demanda. registro: Condição da demanda e prova de conteúdo recebido. falha: Se a sessão não receber a orientação, recuperar o conteúdo pertinente antes de executar. confirmacao: Observar a sessão iniciada e quais insumos ela recebeu. fontes: fonte-cenario ### consulta-fila: Agente de planejamento → consulta demanda → Fila compartilhada natureza: informacao arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Leitura do item pela sessão destinatária já iniciada. inicio: Após a pessoa iniciar a sessão e solicitar a consulta. autoridade: Ler itens endereçados ao agente e produzir a contribuição solicitada. registro: Mesmo item identificado da fila. falha: Item já tratado não deve ser repetido; item incompleto pede esclarecimento. confirmacao: Sessão recupera o ID, o pedido e as fontes corretos. fontes: fonte-cenario ### retorno-fila: Agente de planejamento → devolve resultado → Fila compartilhada natureza: retorno arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Atualização do mesmo item com artefato e condição. inicio: Conclusão ou dependência material da contribuição. autoridade: Registrar resultado no alcance da demanda; compromisso novo exige autoridade própria. registro: Mesmo registro da fila, sem copiar toda a demanda para outra lista. falha: Se gravar falhar, preparar atualização e não marcar como recebida. confirmacao: Reler o item e abrir o artefato vinculado. fontes: fonte-cenario ### recupera-retorno: Agente de revisão → recupera retorno → Fila compartilhada natureza: informacao arquitetura: proposta afirmacao: proposto evidencia: Relação especificada no cenário fictício; sem prova de operação. meio: Nova leitura explícita da fila pela sessão de revisão. inicio: Pessoa retoma a revisão e pede continuação. autoridade: Usar resultado no alcance do caso, conservando fonte e limite. registro: Demanda compartilhada e entrega vinculada. falha: Se não houver retorno, registrar espera e parte independente, sem inventar conclusão. confirmacao: Sessão lê o resultado correto e o relaciona à revisão. fontes: fonte-cenario ## Acompanhar uma passagem entre agentes Início: Revisão identifica uma necessidade de planejamento. Resultado: Contribuição devolvida e recuperada na mesma demanda. ### 1. Registrar o encaminhamento vista: vista-sistema relacao: encaminha entrada: Necessidade e contexto do caso identificados. transformacao: Criar item com destinatário, fontes e resultado esperado. saida: Demanda disponível na fila; destinatário ainda não começou. excecao: Se faltar escrita, preparar item pronto para aplicação assistida. ### 2. Iniciar o destinatário vista: vista-sistema relacao: inicia-parceiro entrada: Item na fila e orientação do agente de planejamento. transformacao: Pessoa abre a sessão e solicita a consulta. saida: Sessão iniciada com conteúdo recebido a conferir. excecao: Sem início, o item permanece em espera. Registro na fila não chama o projeto. ### 3. Recuperar a demanda vista: vista-sistema relacao: consulta-fila entrada: Sessão do destinatário iniciada e acesso à fila. transformacao: Ler identidade, pedido, fontes e condição; verificar se já foi tratado. saida: Demanda correta pronta para contribuição. excecao: Se não houver acesso, informar a operação ausente e usar insumo fornecido quando suficiente. ### 4. Devolver a contribuição vista: vista-sistema relacao: retorno-fila entrada: Resultado ou dependência do planejamento. transformacao: Gravar retorno no mesmo registro e vincular artefato. saida: Demanda atualizada com contribuição localizável. excecao: Falha de escrita deixa atualização preparada, sem declarar recebimento. ### 5. Continuar a revisão vista: vista-sistema relacao: recupera-retorno entrada: Retorno vinculado à demanda original. transformacao: Sessão de revisão lê o resultado e aplica sua contribuição. saida: Revisão continua com contexto preservado. excecao: Ausência ou conflito no retorno pede esclarecer só a parte afetada. ## Fontes ### fonte-cenario · Cenário fictício de colaboração por fila Descrição deste modelo JSON e seus componentes; sem conta ou fonte externa. Edição: 0.1.0 Alcance: Insumo ilustrativo. Sustenta a coerência do desenho; não comprova operação, autorização nem capacidade de plataforma. ## Limites e condições a provar - Exemplo fictício e proposto. Não demonstra chamada direta, sincronização, consulta periódica configurada ou mecanismo de agenda do Cowork. - O início modelado é manual. Substituí-lo por agendamento exige identificar executor, conteúdo recebido, acesso, autoridade e prova de execução, sem mudar a seta por suposição. - A fila seria a fonte da condição compartilhada. O registro do agente conserva contexto próprio e aponta para a demanda; não compete pela condição da fila. - Alternativa suficiente para baixa frequência: a pessoa repassa um artefato identificado. A fila só se justifica se reduzir perda de contexto ou permitir acompanhar a contribuição. - Antes de aplicação real, incorporar os mecanismos e condições comprovados de implantação e passagens. Não existe configuração de conta neste pacote.