Um desenvolvedor identificado no GitHub como O framework roda dentro do Claude Code (ambiente de linha de comando da Anthropic para agentes de c\u00f3digo) ou do OpenAI Codex CLI, sem depend\u00eancias externas. A proposta central \u00e9 dar estrutura, ciclo de vida e controle de qualidade para quando m\u00faltiplos agentes de IA trabalham juntos em um mesmo projeto.<\/p>\n Antes de entrar nos detalhes t\u00e9cnicos, vale entender o problema que o Covenant tenta resolver. Quando voc\u00ea orquestra v\u00e1rios agentes de IA (um pesquisa c\u00f3digo, outro escreve, outro revisa), surgem perguntas que n\u00e3o t\u00eam resposta \u00f3bvia: quem segue quais regras, como os agentes se comunicam entre si, quando param para revisar o pr\u00f3prio trabalho e como o sistema se recupera quando um agente falha ou trava. O Covenant tenta responder essas perguntas com quatro pe\u00e7as: um agente central de interface, um documento de regras imut\u00e1vel, um ciclo de vida com port\u00f5es de verifica\u00e7\u00e3o e um sistema de mem\u00f3ria entre execu\u00e7\u00f5es.<\/p>\n Voc\u00ea nunca fala diretamente com os agentes que fazem o trabalho pesado. Existe um agente chamado Interpreter<\/strong> que \u00e9 o \u00fanico que conversa com o usu\u00e1rio. Ele l\u00ea o seu pedido, verifica o estado atual do sistema (o que j\u00e1 foi feito, que agentes existem, que mem\u00f3rias est\u00e3o dispon\u00edveis), prop\u00f5e um plano dizendo quais agentes espec\u00edficos vai acionar, e espera sua aprova\u00e7\u00e3o antes de agir. S\u00f3 depois que voc\u00ea responde algo como “go”, os agentes s\u00e3o de fato criados (o termo usado \u00e9 spawn<\/em>), executam suas tarefas, escrevem um relat\u00f3rio de sa\u00edda e s\u00e3o desligados.<\/p>\n Esse padr\u00e3o de “um agente de interface, v\u00e1rios agentes de execu\u00e7\u00e3o” n\u00e3o \u00e9 exclusivo do Covenant, mas o projeto formaliza isso como regra arquitetural fixa, n\u00e3o como escolha de implementa\u00e7\u00e3o.<\/p>\n O framework define uma Constitution<\/strong> com 36 se\u00e7\u00f5es de regras que, segundo a documenta\u00e7\u00e3o, s\u00e3o imut\u00e1veis e herdadas por todo agente criado no sistema. Isso funciona como uma camada de configura\u00e7\u00e3o global que todo agente l\u00ea antes de come\u00e7ar a trabalhar, independente de qual tarefa espec\u00edfica ele vai executar. N\u00e3o h\u00e1, no material dispon\u00edvel, o conte\u00fado detalhado dessas 36 se\u00e7\u00f5es, ent\u00e3o n\u00e3o d\u00e1 para saber com precis\u00e3o o que exatamente elas regulam al\u00e9m do que aparece descrito no ciclo de vida.<\/p>\n O Covenant define 12 tipos de agentes com fun\u00e7\u00f5es pr\u00e9-definidas: Interpreter, Analyst, Writer, Synthesist, Guardian, Shepherd, Scribe, Stress Tester, Futility Review, Goal Challenge, James e Executor. A ideia \u00e9 que cada tipo tenha um escopo de atua\u00e7\u00e3o claro (por exemplo, um Analyst pesquisa e investiga, um Writer implementa, um Stress Tester tenta quebrar o que foi feito). Isso \u00e9 diferente de frameworks onde voc\u00ea define agentes gen\u00e9ricos e atribui pap\u00e9is via prompt: aqui os pap\u00e9is j\u00e1 v\u00eam modelados na estrutura do sistema.<\/p>\n Todo agente passa por quatro fases: Vale registrar que essa tabela aparece truncada no README original do projeto, ent\u00e3o essa \u00e9 uma reconstru\u00e7\u00e3o razo\u00e1vel da l\u00f3gica descrita, n\u00e3o uma transcri\u00e7\u00e3o literal.<\/p>\n O componente que d\u00e1 continuidade ao sistema \u00e9 o memory system<\/strong>. Ele \u00e9 composto por exit reports (o relat\u00f3rio que cada agente escreve ao terminar), memos estruturados, uma camada de mem\u00f3ria sem\u00e2ntica e ciclos de consolida\u00e7\u00e3o que, presumivelmente, resumem e comprimem hist\u00f3rico para n\u00e3o acumular contexto infinito. \u00c9 esse mecanismo que permite ao Interpreter, na pr\u00f3xima conversa, saber o que j\u00e1 foi tentado e o que j\u00e1 foi aprendido, sem que o usu\u00e1rio precise repetir contexto.<\/p>\n A edi\u00e7\u00e3o Community inclui 4 runtime hooks<\/em>: agent gate (controle de quem pode ser criado e quando), token logging (registro de consumo de tokens), shutdown orchestration (coordena\u00e7\u00e3o do encerramento de agentes) e session checks (verifica\u00e7\u00e3o de estado da sess\u00e3o). S\u00e3o pontos de intercepta\u00e7\u00e3o no fluxo de execu\u00e7\u00e3o, o tipo de mecanismo que normalmente voc\u00ea implementaria manualmente num orquestrador multi-agente caseiro.<\/p>\n A forma mais r\u00e1pida de experimentar, segundo a documenta\u00e7\u00e3o do projeto, \u00e9 via CLI (interface de linha de comando) descrevendo o que voc\u00ea quer:<\/p>\n Isso gera um projeto completo com c\u00f3digo de agente real, entradas e sa\u00eddas tipadas, relat\u00f3rios de sa\u00edda e heran\u00e7a de mem\u00f3ria j\u00e1 configurados, segundo a descri\u00e7\u00e3o do README.<\/p>\n Para instalar o framework diretamente dentro de um projeto existente com Claude Code:<\/p>\n O fluxo de intera\u00e7\u00e3o descrito no material \u00e9 assim: voc\u00ea escreve um pedido em linguagem natural, o Interpreter responde com um plano dizendo quais agentes vai acionar, e voc\u00ea confirma com um “go” antes de qualquer agente ser de fato criado. N\u00e3o h\u00e1 arquivo de configura\u00e7\u00e3o para escrever nem dashboard para montar, pelo menos na proposta do projeto.<\/p>\n O reposit\u00f3rio tamb\u00e9m tem um exemplo m\u00ednimo em Alguns pontos que limitam onde e como esse framework se aplica hoje:<\/p>\n N\u00e3o testamos o framework rodando um caso real com m\u00faltiplos agentes em paralelo, ent\u00e3o n\u00e3o d\u00e1 para confirmar se os “gates” de fato previnem conflito de escopo na pr\u00e1tica ou se isso depende de o modelo por tr\u00e1s do agente (Claude ou GPT via Codex) seguir instru\u00e7\u00f5es de forma consistente. Tamb\u00e9m n\u00e3o \u00e9 poss\u00edvel afirmar, a partir do material dispon\u00edvel, como o sistema se comporta com um n\u00famero grande de agentes simult\u00e2neos, nem qual \u00e9 a lat\u00eancia ou o custo em tokens adicional que a camada de governan\u00e7a introduz sobre o custo normal de rodar os agentes. O material menciona “token logging” como um dos runtime hooks, o que sugere que o pr\u00f3prio projeto reconhece esse como um custo a ser monitorado, mas n\u00e3o fornece n\u00fameros. Por fim, n\u00e3o h\u00e1 no material informa\u00e7\u00e3o suficiente sobre quem mant\u00e9m o projeto al\u00e9m do autor original, nem sobre plano de suporte a longo prazo.<\/p>\n O caminho mais direto para experimentar sem comprometer um projeto real \u00e9 instalar o Depois, inspecione a estrutura de pastas gerada (procure pelos exit reports e pelos arquivos de mandato de cada agente) antes de rodar qualquer tarefa mais s\u00e9ria. Se voc\u00ea j\u00e1 usa Claude Code no dia a dia, vale tamb\u00e9m clonar o exemplo de Entenda o mecanismo do Covenant Framework: ciclo de vida de agentes, Constitution, memory system e como testar essa camada de governan\u00e7a multi-agente.<\/p>\n","protected":false},"author":2,"featured_media":684,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-685","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts\/685","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/comments?post=685"}],"version-history":[{"count":0,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts\/685\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media\/684"}],"wp:attachment":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media?parent=685"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/categories?post=685"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/tags?post=685"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}asalsali<\/code> publicou o Covenant Framework<\/strong>, um reposit\u00f3rio de c\u00f3digo aberto (edi\u00e7\u00e3o Community) que promete resolver um problema espec\u00edfico de sistemas multi-agente de IA: coordena\u00e7\u00e3o. O projeto foi anunciado no Hacker News sob o t\u00edtulo “Covenant, a governance framework for multi-agent AI systems” e est\u00e1 hospedado em github.com\/asalsali\/covenant-framework-community<\/code>. At\u00e9 o momento da publica\u00e7\u00e3o, o reposit\u00f3rio tinha 4 estrelas, o que indica um projeto ainda inicial e pouco testado pela comunidade.<\/p>\nComo funciona o mecanismo de governan\u00e7a<\/h2>\n
O Interpreter como \u00fanico ponto de contato<\/h3>\n
A Constitution: regras que todo agente herda<\/h3>\n
Doze tipos de agentes com pap\u00e9is fixos<\/h3>\n
O ciclo de vida do agente e os tr\u00eas port\u00f5es<\/h3>\n
SPAWN<\/code> (cria\u00e7\u00e3o), GENESIS PHASE<\/code>, EXECUTE<\/code> e SHUTDOWN<\/code>. A documenta\u00e7\u00e3o descreve tr\u00eas checkpoints obrigat\u00f3rios (chamados de gates<\/em>) ao longo desse ciclo:<\/p>\n\n
Sistema de mem\u00f3ria entre execu\u00e7\u00f5es<\/h3>\n
Runtime hooks<\/h3>\n
O que isso significa na pr\u00e1tica<\/h2>\n
pip install covenant-cli\ncovenant create \"A research app that searches papers and writes reviews\"<\/code><\/pre>\n# Novo projeto\ngit clone https:\/\/github.com\/asalsali\/covenant-framework-community.git my-project\ncd my-project && claude\n\n# Projeto existente (Claude Code)\ncurl -sL https:\/\/raw.githubusercontent.com\/asalsali\/covenant-framework-community\/main\/install.sh | bash\n\n# Via npm\nnpm i covenant-framework<\/code><\/pre>\nexamples\/quickstart\/<\/code>, descrito como demonstra\u00e7\u00e3o de governan\u00e7a “em menos de 30 segundos”, \u00fatil para quem quer ver o mecanismo funcionando sem montar um projeto real primeiro.<\/p>\nOnde quebra<\/h2>\n
\n
O que n\u00e3o d\u00e1 para afirmar ainda<\/h2>\n
Como testar isso voc\u00ea mesmo<\/h2>\n
covenant-cli<\/code> em um diret\u00f3rio novo e vazio:<\/p>\npip install covenant-cli\ncovenant create \"Um app simples que le um arquivo CSV e gera um resumo\"<\/code><\/pre>\nexamples\/quickstart\/<\/code> do reposit\u00f3rio e rodar dentro dele, comparando o comportamento com e sem o framework ativo, para ter uma base pr\u00f3pria de compara\u00e7\u00e3o em vez de depender s\u00f3 do n\u00famero de benchmark divulgado.<\/p>\n","protected":false},"excerpt":{"rendered":"