Tra gli sviluppatori di Anthropic sta trovando spazio una skill per Claude Code chiamata /eli5, progettata per rendere più comprensibili codice, architetture software e concetti tecnici complessi attraverso spiegazioni visuali. Il funzionamento è diretto: l’utente inserisce il comando /eli5 seguito dall’argomento che vuole comprendere e Claude genera un artefatto HTML costruito con testi brevi, immagini di grandi dimensioni e diagrammi semplificati, evitando le risposte molto lunghe tipiche delle spiegazioni tecniche tradizionali. L’obiettivo è fornire una rappresentazione immediata della struttura generale del problema prima di passare all’analisi dettagliata.
La skill può essere utilizzata direttamente durante il lavoro su una codebase. Un programmatore può, per esempio, chiedere /eli5 come funziona questo modulo per ottenere una rappresentazione sintetica delle componenti e delle loro relazioni, oppure interrogare Claude sulle ragioni alla base di una determinata scelta architetturale. Lo stesso approccio può essere applicato alla diagnostica, chiedendo una spiegazione visuale delle cause di un malfunzionamento o di un’interruzione del servizio. Il risultato è simile a una spiegazione effettuata su una lavagna: prima viene mostrato il quadro generale, poi lo sviluppatore può approfondire singoli file, dipendenze, flussi o decisioni implementative.
Questo tipo di funzione diventa particolarmente utile con l’aumento della complessità delle attività affidate agli agenti di coding. Strumenti come Claude Code non vengono più utilizzati soltanto per generare poche righe di codice, ma possono analizzare contemporaneamente numerosi file, intervenire su interi sottosistemi, eseguire refactoring, lanciare test e diagnosticare errori di build. Di conseguenza, il problema per lo sviluppatore non consiste soltanto nel verificare il codice prodotto dall’intelligenza artificiale, ma anche nel comprendere rapidamente la struttura del sistema che l’agente ha analizzato e le motivazioni delle conclusioni raggiunte.
/eli5 interviene soprattutto in questa fase preliminare di comprensione. Prima di modificare effettivamente il codice, lo sviluppatore può utilizzarlo per capire come siano collegati i moduli, quali siano le dipendenze principali, perché una determinata architettura sia stata costruita in un certo modo oppure quale sequenza di eventi abbia portato a un problema operativo. L’approccio può risultare particolarmente utile quando si entra per la prima volta in una codebase, quando si lavora su software sviluppato da un altro team o quando occorre orientarsi rapidamente all’interno di un sistema molto esteso.
La semplificazione visuale non sostituisce però l’analisi tecnica vera e propria. Ridurre sistemi complessi a pochi elementi grafici e brevi spiegazioni può infatti comportare la perdita di dettagli importanti, mentre metafore e analogie troppo semplificate possono introdurre interpretazioni tecnicamente imprecise. Per questo la skill è più adatta a costruire una prima mappa concettuale del sistema che a fornire una documentazione definitiva o una spiegazione completa dell’implementazione. Una volta acquisito il contesto generale, rimane necessario esaminare direttamente codice, documentazione, log, test e dipendenze.
La funzione risponde inoltre a un problema tipico delle interazioni con i modelli linguistici applicati alla programmazione: la tendenza a generare spiegazioni molto estese anche quando lo sviluppatore necessita inizialmente soltanto di comprendere la struttura generale di un problema. Anthropic sta lavorando anche sulla riduzione della verbosità delle risposte, ma un formato esplicitamente visuale può risultare utile quando l’obiettivo non è ancora risolvere il problema, bensì costruire rapidamente un modello mentale del sistema da analizzare.
Al momento /eli5 non fa parte delle funzionalità standard integrate ufficialmente in Claude Code. La skill può essere installata attraverso il marketplace dei plugin della community e Anthropic starebbe valutando la possibilità di trasformarla successivamente in un plugin ufficiale. Il suo utilizzo mostra comunque una possibile evoluzione degli strumenti di coding agentico: oltre a scrivere, modificare e verificare software, gli agenti possono assumere anche il ruolo di livello intermedio di visualizzazione, traducendo l’analisi di codebase complesse in rappresentazioni più facilmente interpretabili dagli sviluppatori.
Questo articolo è stato redatto con il supporto di strumenti di intelligenza artificiale (AI)