O elefante e o peixinho dourado


0

A Lenda do elefante e do peixinho dourado

Elefante lembra,
peixinho nada e esquece:
o lago, flui.

Elefante e peixinho dourado em yin-yang

Nenhum templo do Japão tem registro dessa lenda. Eu inventei agora, no balcão do boteco, mas todo bom framework merece um mito de origem e este aqui não custou nada.

Peça para uma IA escrever um plano e, na sequência, peça para essa mesma IA revisar o plano. Spoiler: ela vai achar excelente. Ninguém é imparcial com a própria obra, nem quem só tem tokens no currículo.

Foi mais ou menos assim que esbarrei no Elephant-Goldfish Model (EGM), um plugin open source criado por gente do Google para desenvolvimento guiado por especificação com agentes de IA. O nome é ridículo, a ideia é boa e a combinação é suspeita o suficiente para merecer um post.


Quem lembra de tudo e quem não lembra de nada

A premissa cabe num guardanapo de boteco. Existem dois tipos de agente, e cada um faz o que o outro não consegue.

O Elefante carrega o contexto inteiro: histórico do sistema, arquitetura, fronteiras entre componentes, jornadas de usuário. É ele quem conversa com você, faz brainstorming e escreve a especificação. Na iconografia budista japonesa, aliás, o bodisatva Fugen anda montado num elefante branco, o que não prova nada, mas dá pedigree ao bicho.

O Goldfish não carrega nada. Cada subagente nasce do zero, lê apenas o rascunho da spec e o código real, e sai atirando críticas sem ter ouvido a sua versão da história. Sem viés de conversa, sem carinho pelo plano e sem aquele constrangimento de contrariar o chefe.

Entre os dois fica o terceiro personagem, que é você. A documentação insiste nisso: a IA explora e audita, o humano decide e responde pelo resultado. Taleb chamaria isso de skin in the game (quem assina a decisão paga a conta, e o peixinho não paga nada).

Elefante entronizado sobre pergaminhos


A biologia mente, mas a metáfora funciona

Um detalhe que me divertiu: os dois bichos são meio fake news. Peixinho dourado guarda informação por meses, e a memória de três segundos é lenda urbana (outra lenda, só que essa pegou). Elefante tem memória excelente, mas a fama de nunca esquecer nada é exagero de folclore.

O método usa a versão do senso comum, que é a que rende metáfora. Ninguém aqui está fazendo zoologia, o que é um alívio para os zoólogos e para Dory.

Elefante e peixinho vendo a lua


Como funciona na prática

O fluxo básico tem sete skills, mas o caminho principal usa quatro comandos:

  • /egm-brainstorm abre uma conversa para lapidar a ideia e dispara um cardume de Goldfish (seis lentes diferentes, segundo a documentação) para tentar derrubar o conceito. O resultado vira um concepts_brief.md;
  • /egm-draft transforma o brief em um design doc dentro de docs/designs/, seção por seção;
  • /egm-review manda Goldfish novos, sem contexto nenhum, avaliarem completude, clareza, autossuficiência e prontidão para implementação; e
  • um humano de verdade revisa o PR, porque a ferramenta faz questão de avisar que não substitui supervisão.

Depois de implementar, entra o /egm-drift-report, que compara a spec com o código e aponta onde os dois se separaram. A recomendação é rodar uma vez por semana, tipo uma consulta de rotina com o dentista, só que o dente é a sua arquitetura. O humano escolhe se corrige o documento ou o código.

Os Goldfish têm personas definidas na pasta agents/: Design Critic, Naive Reader, Tech Lead, Codebase Auditor, Structural Validator, Style Editor e Zoom Out Architect. São sete, o que me lembra os Sete Deuses da Fortuna, só que ninguém aqui vai te dar sorte, só gastar tokens.

Sete peixinhos num navio do tesouro


Um exemplo para a gente rir e entender

O que vem abaixo é uma ilustração hipotética minha, não saída real da ferramenta. Imagine que você quer adicionar uma newsletter ao seu blog.

SEM O EGM:
> "IA, escreve o plano da newsletter"
> "IA, o plano está bom?"
> "Excelente plano, parabéns pelo bom gosto"
> (três semanas depois) descobre que ninguém pensou em descadastro

COM O EGM:
> Elefante conversa, entende o blog, escreve a spec
> Goldfish Naive Reader: "Onde está o fluxo de cancelamento?"
> Goldfish Tech Lead: "Quem garante a entrega de e-mail em escala?"
> Goldfish Codebase Auditor: "Esse endpoint já existe, para que criar outro?"
> Você ajusta a spec antes de escrever uma linha de código 🐠

Perceba que o Naive Reader acerta justamente por não saber nada. Steven Pinker chama isso de maldição do conhecimento: quem sabe demais não consegue mais enxergar o que é óbvio para quem está chegando. O Goldfish é a maldição do conhecimento invertida, vendida como feature.

É também o parente tecnológico do pato de borracha dos programadores, só que o pato escuta e o peixinho responde. Se o pato estiver lendo, o mercado de trabalho dele ficou bem mais difícil.


O que eu acho (você pediu opinião, ou pediria)

A parte que me convence é econômica. Corrigir uma spec custa uma conversa. Corrigir código já escrito sobre uma spec errada custa uma semana e uma crise existencial. Mover a crítica para antes do código é a decisão mais barata da engenharia desde que alguém inventou o git revert.

A segunda parte que me convence é a quebra de viés. Um agente com a conversa inteira na cabeça tende a defender o que ele mesmo propôs, e isso é só um espelho do que humanos fazem em reunião. Reviewer sem contexto é mais difícil de seduzir.

Agora as ressalvas, que ninguém é santo, muito menos peixinho:

  • Goldfish e Elephant, em geral, são o mesmo modelo por baixo. Zero contexto elimina o viés da conversa, mas não elimina pontos cegos que o modelo carrega de fábrica. Essa é uma leitura minha, a documentação não afirma isso;
  • A própria documentação avisa que o review gera muito feedback por design e manda você aproveitar o relevante e ignorar o resto. Quem já encarou oitenta comentários de code review sabe que triagem também cansa;
  • O projeto é jovem, tem poucos commits e o aviso de que não é um produto oficialmente suportado pelo Google. O site diz que milhares de engenheiros do Google usam, mas isso é afirmação da própria página, não de auditoria independente; e
  • Para corrigir um bug de uma linha, usar um cardume de peixes é matar mosquito com bazuca. O próprio guia concorda: se dá para resolver de primeira, resolva.

Mesmo assim, saí do README.MD com a sensação de que o valor central independe da ferramenta. Dá para aplicar a ideia com um chat novo, colando só a spec e pedindo para um modelo sem histórico destruir o plano. Segundo a documentação, essa versão manual não custa nada além do seu tempo e serve para testar se as respostas melhoram antes de instalar qualquer coisa.


Se quiser instalar

O jeito mais preguiçoso é pedir ao seu agente: Install https://github.com/google/elephant-goldfish-model. Para os de gosto mais cerimonial:

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

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

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

No Claude Code os comandos ganham o prefixo /egm:, então o brainstorm vira /egm:egm-brainstorm.

O humano com o hanko


O que sobra depois do cardume

Existe uma lenda de verdade (de origem chinesa, mas muito popular no Japão) em que a carpa que consegue subir a cachoeira do Portão do Dragão vira dragão. Cada spec passa pela sua própria cachoeira de Goldfish. As que sobem viram código. As outras viram café frio.

Peixinho subindo a cachoeira

No fim das contas, o método devolve uma verdade desconfortável: a IA mais útil nem sempre é a que concorda com você. Boa parte do valor está em ter um agente que lembra de tudo para escrever e outro que não lembra de nada para duvidar. Com humanos também funciona assim, o que explica por que ninguém lê o próprio texto com olhos limpos.

Spec e código à deriva

(Este texto, aliás, não passou por nenhum Goldfish. Se achou um erro, o peixinho agora é você)


Para ver de onde tirei isso tudo:

Todas as imagens deste post foram geradas por peixinhos dourados.