Elephant-Goldfish Model (EGM) é um plugin open source do Google para melhorar a etapa que quase sempre decide se um projeto de software vai dar certo: o desenho antes da implementação. Ele não promete substituir a equipe por agentes. Em vez disso, organiza um fluxo em que um agente com contexto ajuda a desenvolver a ideia, enquanto revisores novos — sem a conversa anterior — procuram premissas ocultas, ambiguidade e riscos de implementação.

A metáfora explica o método. O Elephant guarda o contexto do projeto, dos requisitos e das decisões anteriores para construir uma especificação. O Goldfish recebe apenas o documento e os arquivos citados, sem a memória da conversa que levou àquela solução. A intenção é simples: um revisor que não acompanhou todos os passos tem mais chance de perguntar “por que isso é verdade?” antes de concordar com uma decisão mal fundamentada.

Identidade visual do Elephant-Goldfish Model
Identidade visual oficial do Elephant-Goldfish Model, projeto open source do Google.

O problema que o EGM tenta resolver

Agentes de código aceleram a produção de arquivos, testes e pull requests. O risco é acelerar também decisões vagas. Uma solicitação como “adicionar webhooks” parece objetiva até surgirem perguntas sobre idempotência, tentativas, ordenação de eventos, falhas, autenticação, limites de taxa, retenção, observabilidade e compatibilidade com clientes existentes.

Quando a mesma conversa carrega todo o raciocínio, o agente pode ficar ancorado nas primeiras escolhas. Ele lembra por que uma hipótese apareceu e tende a tratá-la como requisito. O EGM tenta quebrar esse efeito com revisão por contexto fresco. O Goldfish não recebe o histórico, só a proposta e o material que ela diz usar. Se a especificação não explica uma decisão, o revisor precisa apontar a lacuna — não completar a história com memória de chat.

Elephant, Goldfish e você: os três papéis

PapelContexto disponívelResponsabilidade
ElephantProjeto, requisitos, código e decisões anterioresExplorar opções e redigir a especificação
GoldfishDocumento em revisão e fontes referenciadas, sem conversa anteriorEncontrar omissões, suposições e riscos
Pessoa responsávelObjetivos, restrições e contexto de negócioResolver trade-offs e aprovar o que será implementado
O repositório deixa explícito que a decisão arquitetural continua humana.

Esse último papel é importante. EGM não se apresenta como um mecanismo de aprovação automática. Os revisores identificam problemas; a equipe escolhe quais achados corrigir, quais riscos aceitar e qual design aprovar. Revisão também não substitui testes, monitoramento, controle de acesso ou julgamento humano.

O fluxo padrão: ideia, rascunho, revisão e decisão

O caminho recomendado pelo projeto é composto por quatro momentos:

  1. Brainstorm: explorar o problema com o agente, levantar requisitos e discutir trade-offs. O resultado é um concepts_brief.md.
  2. Draft: transformar o brief em uma especificação de design, guardada inicialmente como design_draft.md.
  3. Review: criar revisores com contextos novos para avaliar clareza, aderência ao código, plano de implementação e riscos.
  4. Resolve: discutir os achados, decidir as alterações e só então aprovar a especificação para implementação.

Depois da aprovação, o repositório sugere arquivar o documento em docs/designs/. Isso transforma decisões que normalmente desaparecem numa conversa em conhecimento versionado junto ao código.

As sete skills do EGM

SkillUso principalEntrega esperada
egm-brainstormTestar uma ideia antes de assumir uma soluçãoBrief de conceito com decisões e perguntas abertas
egm-draftConverter notas e brief em especificaçãoRascunho de design estruturado
egm-reviewRevisar um design com agentes isoladosAchados organizados por estágios de revisão
egm-resolveResolver recomendações da revisãoDecisões explícitas sobre cada item
egm-review-loopExecutar um grupo configurável de revisoresRevisão direcionada para um objetivo específico
egm-bootstrapDocumentar uma base de código existenteMateriais de orientação e entendimento do projeto
egm-drift-reportComparar documentação com o código atualRelatório de divergências entre intenção e implementação
Resumo editorial das skills e objetivos descritos no repositório.

O que significa “revisor sem memória” na prática

O EGM exige que brainstorming e revisão sejam executados em ambientes capazes de criar subagentes novos. O motivo é técnico: abrir uma nova conversa não basta se o subagente ainda herda automaticamente memória, histórico, logs ou instruções privadas que expliquem a solução. A revisão precisa ver somente o que uma pessoa que recebe a especificação veria.

Isso traz duas consequências. A primeira é positiva: obriga o documento a se sustentar sozinho. A segunda é uma limitação importante: EGM não consegue garantir isolamento absoluto do sistema de arquivos, de permissões ou da memória configurada pelo ambiente que hospeda os agentes. O próprio projeto documenta limites por harness e alerta que o comportamento depende da integração escolhida.

Instalação em Claude Code, Codex e ChatGPT

O repositório distribui o plugin completo, não apenas arquivos de skills. Isso importa porque os revisores usam prompts, personas e padrões que acompanham o bundle. Copiar somente a pasta skills/ pode deixar o fluxo incompleto.

# Claude Code
claude plugin marketplace add google/elephant-goldfish-model
claude plugin install egm@egm

# Codex CLI
codex plugin marketplace add google/elephant-goldfish-model
codex plugin add egm@egm

# Antigravity CLI
agy plugin install https://github.com/google/elephant-goldfish-model

O README pede uma sessão nova depois da instalação. Em Claude Code e Antigravity, os comandos usam o prefixo /egm:, como /egm:egm-brainstorm. No Codex, o usuário seleciona a skill correspondente pelo seletor de skills. Para ChatGPT desktop, o projeto informa uma listagem de plugin publicada; para importação em workspace ChatGPT, a documentação menciona o repositório e o caminho de marketplace .agents/plugins.

Exemplo: desenhando entrega de webhooks

O README usa webhooks como primeiro exercício. Em vez de começar com endpoint, banco e fila, o fluxo parte das perguntas que definem o contrato: o que acontece quando uma entrega falha? Como eventos duplicados são identificados? A ordem é garantida? Qual assinatura autentica a mensagem? Haverá replay? O cliente pode receber o mesmo evento duas vezes?

/egm:egm-brainstorm Adicione entrega de webhooks a este projeto.

# Após discutir e salvar o brief:
/egm:egm-draft

# Use o caminho retornado pelo agente:
/egm:egm-review design_draft.md

Em seguida, a equipe avalia os findings e implementa apenas quando houver uma especificação aprovada. Esse método não torna o desenvolvimento necessariamente mais curto para tarefas pequenas. Ele evita, porém, que um sistema com requisitos transacionais seja construído em cima de decisões implícitas.

Bootstrap e relatório de drift

Duas skills são particularmente úteis em repositórios antigos. egm-bootstrap ajuda a produzir ou atualizar documentação de uma base de código que já existe. egm-drift-report compara essa documentação com os fontes atuais para indicar onde o que está registrado deixou de corresponder ao que o software faz.

Isso é relevante porque documentação de arquitetura tende a envelhecer. Uma decisão pode continuar registrada como “o sistema usa fila X”, enquanto uma migração parcial passou a usar fila Y em produção. Um relatório de drift não corrige o sistema sozinho, mas cria uma lista verificável de divergências que a equipe pode priorizar.

✅ Onde o EGM é mais útil

  • Features com decisões difíceis: pagamentos, autenticação, webhooks, migrações e APIs públicas.
  • Projetos com mais de uma equipe: uma especificação revisada reduz o custo de explicar de novo por que uma escolha foi feita.
  • Repositórios maduros: bootstrap e drift report ajudam a transformar conhecimento disperso em documentação útil.
  • Uso intenso de agentes: a revisão fresca reduz a chance de um agente implementar com confiança uma premissa que nunca foi validada.

⚠️ Limites e cuidados

  • Não é uma garantia de correção. Revisores podem errar, omitir riscos ou chegar a sugestões ruins.
  • Não substitui testes. O próprio README afirma que uma revisão não toma o lugar de testes automatizados nem de julgamento humano.
  • Consome contexto e uso de modelo. Subagentes novos podem aumentar consumo, latência e custo conforme o ambiente.
  • Isolamento depende do harness. Um novo contexto não implica que o sistema de arquivos, permissões ou memória configurada estejam isolados.
  • Exige disciplina documental. Se ninguém atualiza as especificações aprovadas, o relatório de drift só vai medir uma dívida que continua crescendo.

Segurança e privacidade antes de instalar

Plugins de agentes devem ser tratados como código de terceiros. Antes de instalá-los em um repositório corporativo, revise as instruções, os caminhos de arquivo que eles podem ler, as permissões que o harness concede a subagentes e o comportamento das integrações. O EGM declara não instalar servidor MCP próprio, mas isso não elimina riscos criados pelo ambiente host ou pelas ferramentas que o usuário autoriza.

Também vale separar revisão de design de aprovação operacional. Um reviewer pode sugerir alterar infraestrutura, criar secrets ou mudar permissões; essas ações devem continuar protegidas por revisão humana e controles de deploy. A recomendação segura é começar em uma branch ou repositório de laboratório, validar o fluxo com um recurso pequeno e só então padronizar a instalação para o time.

Troubleshooting: erros prováveis

  • ❌ A revisão não inicia. Causa: o agente/harness não cria subagentes frescos. Solução: use um ambiente suportado ou faça a revisão com uma sessão separada e contexto cuidadosamente limitado.
  • ❌ A skill não encontra os prompts de review. Causa: foram copiados apenas os arquivos de skills. Solução: instale o plugin completo, incluindo personas e referências.
  • ❌ O revisor repete informações da conversa anterior. Causa: o ambiente injeta memória, histórico ou regras globais. Solução: verifique os limites de isolamento documentados pelo harness e reduza contexto compartilhado.
  • ❌ O fluxo virou burocracia. Causa: foi aplicado a toda alteração, inclusive correções triviais. Solução: use a sequência completa apenas quando houver decisão arquitetural, risco ou contrato relevante.
  • ❌ O design está aprovado, mas o código divergiu. Causa: mudanças foram implementadas sem atualizar o documento. Solução: rode egm-drift-report periodicamente e trate divergências como trabalho de manutenção.

Vale a pena?

O Elephant-Goldfish Model é relevante porque enfrenta um problema real do desenvolvimento com IA: velocidade de implementação não é a mesma coisa que qualidade de decisão. Ao separar quem desenvolve a proposta de quem tenta desmontá-la sem o conforto da conversa anterior, o projeto incentiva especificações mais claras e rastreáveis.

Na análise do NoticIA, EGM é mais interessante como disciplina de engenharia do que como “framework mágico de agentes”. Ele pode ajudar uma equipe a usar IA com menos impulsividade, desde que os humanos mantenham a autoridade para definir requisitos, revisar riscos e aprovar mudanças. O código é licenciado sob Apache 2.0 e o repositório avisa que não é um produto oficialmente suportado pelo Google.


Descubra mais sobre noticiAI

Assine para receber nossas notícias mais recentes por e-mail.

Deixe seu comentário