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.
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
| Papel | Contexto disponível | Responsabilidade |
|---|---|---|
| Elephant | Projeto, requisitos, código e decisões anteriores | Explorar opções e redigir a especificação |
| Goldfish | Documento em revisão e fontes referenciadas, sem conversa anterior | Encontrar omissões, suposições e riscos |
| Pessoa responsável | Objetivos, restrições e contexto de negócio | Resolver trade-offs e aprovar o que será implementado |
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:
- Brainstorm: explorar o problema com o agente, levantar requisitos e discutir trade-offs. O resultado é um
concepts_brief.md. - Draft: transformar o brief em uma especificação de design, guardada inicialmente como
design_draft.md. - Review: criar revisores com contextos novos para avaliar clareza, aderência ao código, plano de implementação e riscos.
- 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
| Skill | Uso principal | Entrega esperada |
|---|---|---|
egm-brainstorm | Testar uma ideia antes de assumir uma solução | Brief de conceito com decisões e perguntas abertas |
egm-draft | Converter notas e brief em especificação | Rascunho de design estruturado |
egm-review | Revisar um design com agentes isolados | Achados organizados por estágios de revisão |
egm-resolve | Resolver recomendações da revisão | Decisões explícitas sobre cada item |
egm-review-loop | Executar um grupo configurável de revisores | Revisão direcionada para um objetivo específico |
egm-bootstrap | Documentar uma base de código existente | Materiais de orientação e entendimento do projeto |
egm-drift-report | Comparar documentação com o código atual | Relatório de divergências entre intenção e implementação |
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-modelO 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.mdEm 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-reportperiodicamente 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.
