Guida Elephant Goldfish Model
Guida Elephant Goldfish Model
L’Elephant-Goldfish Model (EGM) è un metodo open source nato in Google e distribuito come plugin per agenti di coding: un agente “Elefante” ricorda tutto del progetto e scrive la specifica, mentre agenti “Goldfish” senza memoria la mettono sotto pressione prima che venga scritta una sola riga di codice. In questa guida scopri cos’è, come funziona, come installarlo con Claude Code e con Antigravity, quali sono vantaggi e limiti, e perché il tuo team deve continuare a formarsi.
Indice dei contenuti – Guida Elephant Goldfish Model
1. Cos’è l’Elephant-Goldfish Model e perché se ne parla ora
3. Come funziona: l’Elefante, i Goldfish e tu
4. Le tre fasi del ciclo: brainstorm, draft e review
5. Il Protocollo di Revisione dei Goldfish
6. Esempio pratico: installare EGM con Claude Code
7. Esempio pratico: installare EGM con Antigravity
8. Il tuo primo design con EGM: dal brainstorm alla review
9. Vantaggi e possibili svantaggi
10. L’AI sta cambiando il lavoro degli sviluppatori: perché la formazione continua fa la differenza
11. I Corsi AI Generativa di Innovaformazione: richiedi informazioni e preventivo
1. Cos’è l’Elephant-Goldfish Model e perché se ne parla ora
Venerdì sera, ore 18:40. Luca, sviluppatore in una PMI di logistica che chiameremo Rotta Veloce, chiede al suo agente di coding di aggiungere le notifiche webhook al gestionale. L’agente lavora veloce, i test passano, il codice è pulito. Il lunedì mattina Marta, la tech lead, trova il supporto clienti in fiamme: ogni notifica è arrivata tre volte, e quando un cliente era offline, quella notifica non è arrivata affatto. Nessuno aveva deciso cosa dovesse succedere in questi casi. L’agente, semplicemente, non l’aveva chiesto.
È il problema che l’Elephant-Goldfish Model prova a risolvere. Il Google Open Source Blog, nel post del 22 Ottobre 2026 firmato dal team EGM, lo descrive così: la velocità dell’AI nel generare codice porta con sé anche più “slop”, più bug e il collasso del contesto di sessione; senza guardrail strutturati si finisce per scalare gli errori invece di scrivere codice più in fretta. La risposta proposta è spostare l’attenzione dal codice al progetto. Come scrive il co-autore Dave Rensin, “Design is the new code”.
Il metodo nasce dal saggio Elephants, Goldfish and the New Golden Age of Software Engineering di Rensin, Distinguished Engineer di Google, pubblicato nel 2026. Il plugin, sviluppato inizialmente per uso interno, è stato rilasciato in open source con licenza Apache 2.0, e secondo Google viene usato ogni giorno da migliaia di ingegneri per rilasciare codice di produzione. Una precisazione onesta, riportata anche nel repository: non si tratta di un prodotto ufficialmente supportato da Google. È un progetto aperto, che puoi leggere, personalizzare e adattare al tuo team.
Al momento della nostra ricerca (vedi data articolo) il repository google/elephant-goldfish-model conta circa 3.200 stelle su GitHub e il progetto è in rapida evoluzione, quindi controlla sempre la documentazione ufficiale prima di installarlo.
2. Cosa fa il plugin EGM – Guida Elephant Goldfish Model
Il plugin non scrive il tuo software al posto tuo. Fa una cosa diversa e, per certi versi, più utile: organizza il lavoro di progettazione con l’AI in un processo ripetibile. Secondo il blog di Google, automatizza il ciclo di vita del metodo gestendo il passaggio di contesto tra Elefanti e Goldfish, facilitando i cicli di validazione e producendo i documenti di design. Il ruolo dello sviluppatore passa da quello di chi controlla ogni riga a quello di revisore con responsabilità decisionale.
Il repository descrive il progetto come un insieme di skill open source per progettare e rivedere software con agenti AI. Ogni skill si può usare quando serve, senza seguire per forza l’intera sequenza:
- Brainstorm: mette alla prova un’idea e produce un concept brief.
- Draft: trasforma il brief, o semplici appunti, in un documento di design.
- Review: rivede il design con agenti “freschi”, in più stadi.
- Resolve: ti guida nell’analisi dei problemi emersi e nella scelta delle modifiche.
- Bootstrap: crea o aggiorna la documentazione di una codebase esistente.
- Review loop: esegue un gruppo configurato di revisori per un compito specifico.
- Drift report: confronta i documenti versionati con il codice attuale per scoprire divergenze.
Un ultimo punto da tenere a mente: il repository stesso avverte che EGM serve quando una funzionalità richiede decisioni di progetto prima dell’implementazione. Per un bug piccolo e chiaro, la raccomandazione è di usare il tuo normale flusso di lavoro.
3. Come funziona: l’Elefante, i Goldfish e tu
Continuiamo la nostra Guida Elephant Goldfish Model. Immagina due colleghi. Il primo è il senior che lavora con te da anni: conosce l’architettura, ricorda perché sei passato da una coda all’altra e sa quali compromessi avete accettato. Il secondo è un neoassunto che oggi apre il laptop per la prima volta e legge solo il documento che gli consegni. Se dopo la lettura non riesce a spiegarti il piano, il problema non è lui: è il documento. EGM è esattamente questo, con gli agenti AI al posto dei colleghi.
L’Elefante è una sessione AI ricca di contesto e a lungo orizzonte, che custodisce la visione architetturale e la memoria del progetto. Secondo il blog di Google, in questa sessione non si scrive codice: ci si dedica a design, intenzioni e micro-decisioni. È il luogo in cui l’AI ti intervista e tu discuti i pro e i contro delle tue scelte.
I Goldfish sono sessioni senza stato e senza contesto, usate esclusivamente per validare le specifiche. Non condividono i “punti ciechi” del progettista, quindi funzionano da critici oggettivi che cercano lacune e casi limite.
Tu sei il terzo elemento, e il più importante. Il README del progetto lo dice chiaramente: sei tu a risolvere i compromessi architetturali e ad approvare la specifica prima dell’implementazione. L’obiettivo dichiarato dal metodo è che l’AI produca correttamente il codice che volevi al primo tentativo, dopo che hai premuto Invio.
C’è un vincolo tecnico che vale la pena sottolineare: le revisioni dei Goldfish richiedono contesti freschi, cioè la possibilità di creare nuovi subagenti. Se il tuo agente non può farlo, EGM interrompe la revisione invece di eseguirla nello stesso contesto, dove il risultato sarebbe falsato.
4. Le tre fasi del ciclo: brainstorm, draft e review – Guida Elephant Goldfish Model
Torniamo a Rotta Veloce. Dopo il disastro dei webhook, Marta decide di non vietare l’AI ma di darle un metodo. Il ciclo che adotta è quello descritto dal blog di Google, in tre fasi.
Fase 1, far crescere l’Elefante (egm-brainstorm). Carichi il contesto del sistema e lavori con la regola “niente codice”: progetti la funzionalità, discuti i compromessi e metti in discussione le ipotesi. Secondo la guida del repository, il comando ti chiede di chiarire il concetto, poi attiva uno sciame di Goldfish, con sei punti di vista diversi, per stressare l’idea e generare un documento concepts_brief.md.
Fase 2, scrivere con l’Elefante (egm-draft). Insieme all’agente redigi, sezione dopo sezione, un documento di design in Markdown. Come descrive il blog, deve coprire la definizione del problema, il piano tecnico, le alternative considerate e un piano di implementazione dettagliato che elenca i file da modificare. L’agente si ferma dopo ogni sezione per raccogliere il tuo feedback in chat, e il risultato è salvato in design_draft.md e poi archiviato in docs/designs/.
Fase 3, il Protocollo dei Goldfish (egm-review). Il modello passa dalla co-progettazione alla validazione avversariale, con istanze senza stato che cercano i punti deboli del progetto. Ne parliamo nel prossimo paragrafo.
Chiusa la review, la guida ufficiale suggerisce di inviare il design a un altro essere umano tramite Pull Request, perché EGM non sostituisce la supervisione umana ma la incoraggia. Solo dopo si chiede all’AI di implementare il piano. Se il codice prodotto è sbagliato in modo grossolano, la raccomandazione è di aggiornare il documento di design e riprovare, non di rattoppare il codice.
Due strumenti di contorno meritano una citazione. Il drift report, da eseguire secondo la guida una volta a settimana, segnala quando documenti e codice si sono allontanati: sta a te decidere se aggiornare l’uno o l’altro. Il bootstrap, invece, genera README per le directory di una codebase esistente con un processo dal basso verso l’alto, per dare all’Elefante una mappa del sistema.
5. Il Protocollo di Revisione dei Goldfish – Guida Elephant Goldfish Model
È il cuore del metodo. Il blog di Google lo definisce un passaggio dalla co-progettazione alla validazione avversariale, in cui istanze AI senza stato cercano i punti deboli del documento. Il plugin automatizza una sequenza di tre controlli.
1. Comprehension Check (verifica di comprensione). Un Goldfish senza memoria legge l’intero documento di design e deve spiegare all’Elefante architettura e intenzioni. Se non riesce a riassumere il piano in modo corretto, vuol dire che il documento è ambiguo e richiede altro lavoro di stesura.
2. Antagonistic Review (revisione antagonista). Più istanze di Goldfish assumono il ruolo di revisori tecnici scettici e ostili. Il loro compito è individuare casi limite, dipendenze nascoste e lacune logiche. Le critiche tornano alla sessione dell’Elefante per essere risolte.
3. Implementation Readiness Check (controllo di prontezza). Un ultimo Goldfish esegue una verifica rigorosa di tipo go/no-go. Controlla che tutte le informazioni necessarie, cioè percorsi dei file, strutture dati e firme delle funzioni, siano presenti e prive di ambiguità, così la specifica può essere trascritta in codice con precisione.
Pensala come il collaudo di un impianto prima dell’accensione: prima verifichi che il progetto si capisca, poi lo attacchi con tutte le domande scomode, infine controlli che i dettagli per costruirlo ci siano davvero. Nel caso di Rotta Veloce, un revisore “ostile” avrebbe chiesto subito: cosa succede se lo stesso evento arriva due volte? E se il cliente non risponde? Sono le due domande che al team erano sfuggite.
Un’avvertenza: il README del repository descrive la review come un’analisi in cinque stadi, che controlla il design, la sua chiarezza, la coerenza con il codice e il piano di implementazione, mentre il post del blog riassume il protocollo in tre passaggi. Le due descrizioni non sono in contraddizione: il progetto evolve e la documentazione del repository è la fonte più aggiornata. Un altro consiglio ufficiale: la review produce volutamente molto feedback. Prendi ciò che ti serve e ignora il resto.
6. Esempio pratico: installare EGM con Claude Code
Passiamo alla pratica per la nostra Guida Elephant Goldfish Model. Per installare EGM in Claude Code ti servono solo due comandi da terminale, indicati nel README del repository. Il primo registra il repository come marketplace di plugin, il secondo installa il plugin egm da quel marketplace:
claude plugin marketplace add google/elephant-goldfish-model
claude plugin install egm@egm
Dopo l’installazione avvia una nuova sessione, come raccomanda il README. Dentro Claude Code puoi verificare che il plugin sia attivo con il comando /plugin list, descritto nella documentazione ufficiale di Claude Code. Per usare le skill, ricorda che quelle dei plugin hanno come prefisso il nome del plugin: nel caso di EGM, /egm:egm-brainstorm, /egm:egm-draft e /egm:egm-review.
Due note pratiche, entrambe dalla documentazione ufficiale di Claude Code. La prima: il comando claude plugin install installa per impostazione predefinita nell’ambito utente, ma puoi usare l’opzione –scope project per installarlo per tutti i collaboratori di un repository, il che è comodo per un team intero. La seconda: Anthropic avverte che i plugin possono eseguire codice sul tuo computer con i tuoi privilegi, quindi installa solo plugin di cui ti fidi. Il repository di Google è sotto licenza Apache 2.0 e il suo codice è pubblico: leggilo prima di adottarlo in azienda.
Se non vuoi installare nulla, il README di Google offre anche una via per provare le idee senza strumenti: la guida consiglia di percorrere a mano la sequenza conversazionale una o due volte, per sviluppare intuito sul comportamento degli LLM prima di automatizzare.
7. Esempio pratico: installare EGM con Antigravity
Antigravity è l’ambiente in cui il plugin è stato concepito: il blog di Google dice che l’obiettivo principale è portare il framework EGM direttamente in Antigravity, con altri ambienti di sviluppo in arrivo. Il README indica un solo comando da shell:
agy plugin install https://github.com/google/elephant-goldfish-model
È lo stesso formato previsto dalla documentazione ufficiale di Antigravity per installare un plugin da un link GitHub: agy plugin install https://github.com/<owner>/<repo>. Se preferisci l’interfaccia interattiva, dentro una sessione puoi usare il comando /plugin, e sempre la documentazione ufficiale indica /plugin list, /plugin enable, /plugin disable e /plugin uninstall per gestire i plugin già installati.
Anche qui, avvia una nuova sessione dopo l’installazione. In Antigravity le skill si chiamano senza prefisso: /egm-brainstorm, /egm-draft e /egm-review. Un dettaglio importante dalla documentazione di EGM: installa sempre il plugin completo e non copiare solo la cartella skills/, perché le skill leggono i prompt dei revisori e gli standard dei documenti durante l’esecuzione.
Una nota di trasparenza sulla documentazione. Durante la ricerca ho visto che il README principale elenca Antigravity, Claude Code e Codex, mentre alcune pagine del repository (la guida di avvio e la pagina sugli ambienti supportati) citano ancora Antigravity e Gemini CLI come ambienti della prima release. Il repository è in evoluzione: prima di rollout aziendali, verifica la pagina docs/harnesses.md e il README aggiornati.
8. Il tuo primo design con EGM: dal brainstorm alla review
Marta propone a Luca di rifare il lavoro sui webhook, questa volta col metodo. Apre il progetto nell’agente e usa lo stesso scenario che il README suggerisce come primo esercizio: aggiungere la consegna di webhook, chiedendosi cosa deve succedere se una consegna fallisce o se lo stesso evento arriva due volte. Ecco i tre comandi, scritti con la sintassi di Antigravity (in Claude Code aggiungi il prefisso /egm:):
# 1. Esplora l’idea: discuti requisiti e compromessi con l’agente
/egm-brainstorm Add webhook delivery to this project.
# 2. Trasforma il brief in un documento di design, sezione per sezione
/egm-draft
# 3. Fai rivedere il design ai Goldfish (usa il percorso restituito dall’agente)
/egm-review design_draft.md
Nel primo passaggio l’agente ti intervista e dei Goldfish sfidano la proposta; l’accordo raggiunto viene salvato in concepts_brief.md. Nel secondo, l’agente scrive design_draft.md e si ferma dopo ogni sezione per chiederti un parere. Nel terzo, i revisori controllano il design, la sua chiarezza, la coerenza con il codice e il piano di implementazione, e tu scegli quali osservazioni accogliere. Quando approvi il design, chiedi all’agente di implementarlo.
Per Luca è un’esperienza nuova. Il revisore antagonista gli chiede come gestirà i duplicati e i tentativi falliti, e lui si accorge di non aver mai deciso nulla in merito. Invece di scoprirlo a produzione, lo scopre davanti a un documento Markdown, modificabile in cinque minuti. Il lunedì dopo, nessun cliente riceve tre notifiche.
Se vuoi tenere tutto in ordine, la guida ufficiale suggerisce di salvare le specifiche approvate sotto docs/designs/ e, per un progetto esistente, di creare una skill di contesto, opzionale ma raccomandata, che spieghi all’agente cos’è il tuo progetto e dove trovare i documenti più rilevanti. Con il tempo l’Elefante ritrova così la storia architetturale del progetto.
9. Vantaggi e possibili svantaggi
Nessun metodo è gratis, e EGM non fa eccezione. La tabella riassume i punti emersi dalle fonti ufficiali, con qualche considerazione pratica.
| Aspetto | Vantaggi | Possibili svantaggi |
| Qualità del design | Ambiguità e casi limite emergono prima di scrivere codice, grazie a revisori senza i punti ciechi del progettista. | La review genera molto feedback per scelta: serve tempo per selezionare ciò che conta. |
| Controllo umano | Le decisioni architetturali restano a te; il metodo prevede anche la revisione di un collega via Pull Request. | Non sostituisce test e giudizio umano: richiede un team disposto a leggere e discutere i documenti. |
| Memoria del progetto | Il design resta documentato in Markdown e il drift report segnala quando codice e documenti divergono. | Va mantenuto: senza disciplina settimanale i documenti invecchiano. |
| Adozione e licenza | Open source con licenza Apache 2.0, personalizzabile e già usato da migliaia di ingegneri Google. | Non è un prodotto ufficialmente supportato da Google; il supporto degli ambienti varia e va verificato. |
| Costi e proporzioni | Evita rifacimenti costosi in fase di implementazione. | Per bug piccoli e chiari è eccessivo, come dice il README. Più sessioni e subagenti richiedono in genere più tempo e più risorse di calcolo. |
Il requisito tecnico più importante resta quello dei contesti freschi: se il tuo agente non può creare subagenti, la review non parte. Verificalo prima di promettere il metodo al tuo team.
10. L’AI sta cambiando il lavoro degli sviluppatori: perché la formazione continua fa la differenza
Rileggi la storia di Rotta Veloce. Il problema non era il codice: era la competenza di chi guidava l’AI. Luca sapeva usare l’agente, ma nessuno gli aveva insegnato a diffidare della sua velocità, a progettare prima di generare, a far criticare un’idea prima di costruirla. Questo, oggi, è il lavoro dello sviluppatore.
Lo dicono le stesse fonti di Google: quando generare codice costa poco, il valore si sposta su comprensione del sistema, qualità delle specifiche e capacità di giudizio. “Human judgment is the artifact”, scrivono gli autori del blog: il giudizio umano è l’unico artefatto che conta davvero in un mondo saturo di AI. Strumenti come EGM non eliminano la competenza, la pretendono. Chi non sa scrivere un buon documento di design, o riconoscere un’ambiguità, non ottiene vantaggi da dieci Goldfish.
Il ritmo è un altro fattore. Nel giro di pochi mesi sono cambiati i modi di installare plugin, i comandi, gli ambienti supportati: nella stessa documentazione di EGM abbiamo visto pagine non perfettamente allineate tra loro, segno di un ecosistema che corre. Un team che si ferma a un corso di due anni fa si trova presto a usare strumenti che non esistono più nella forma che conosce.
Solo la formazione continua del team aziendale consente di restare al passo con questi cambiamenti. Non è un costo accessorio: è la differenza tra un’AI che amplifica le competenze dei tuoi sviluppatori e un’AI che amplifica i loro errori. Imparare ad usare bene agenti, plugin, skill e metodi di design assistito è una competenza di base per chi sviluppa software oggi, e va aggiornata come si aggiornano i framework.
11. I Corsi AI Generativa di Innovaformazione: richiedi informazioni e preventivo
Se vuoi che il tuo team passi dalla curiosità alla pratica, ti consiglio caldamente i Corsi AI Generativa di Innovaformazione. Tra questi, due sono i “più caldi” per chi sviluppa:
- Corso Claude Code per sviluppatori: Per imparare a lavorare con Claude Code nel ciclo di sviluppo reale, inclusi plugin e skill come quelli visti in questa guida.
- Corso sviluppo applicazioni LLM: Per progettare e costruire applicazioni basate su modelli linguistici.
I corsi sono attivati su richiesta, in modalità online in classe virtuale, con un calendario da concordare con te. L’approccio è hands-on: programmi insieme al docente seguendo un caso di studio che accompagna l’intero percorso, così quello che impari lo applichi subito sul tuo codice.
Richiedi informazioni e preventivo:
- Email: info@innovaformazione.net
- Telefono: 347 1012275 (Dario Carrassi)
- Sito: www.innovaformazione.net
Per altri articoli tecnici di settore consigliamo di navigare sul nostro blog QUI.
Articoli correlati
Claude Code con Arduino
Novità .Net 11
Backdoor nei modelli AI open-weight
Opportunità di lavoro Bari
Spieghiamo il Weight space programming
