La scorsa settimana abbiamo rilasciato i workflow dinamici in Claude Code. Ora Claude è in grado di scrivere al volo il proprio harness, personalizzato per il compito specifico.
Sebbene l'harness predefinito di Claude Code sia progettato per la programmazione, è utile anche per molti altri tipi di attività perché, come si scopre, molte attività assomigliano a compiti di programmazione. Ma esistono alcune categorie di attività per le quali abbiamo dovuto costruire harness personalizzati sopra Claude Code per ottenere prestazioni ottimali, come la Ricerca, l'analisi della sicurezza, i team di agenti o la Revisione del codice.
I workflow ti permettono di creare dinamicamente harness che consentono a Claude di risolvere tutti questi problemi e molti altri nativamente all'interno di Claude Code. Puoi anche condividere e riutilizzare questi workflow con altri.
In questo articolo, parlerò delle mie prime esperienze con i workflow e di ciò che ho imparato, in modo che tu possa sfruttarli al massimo.
Detto questo, le best practice sono ancora in evoluzione! I workflow dinamici tendono a utilizzare più token, quindi valuta attentamente quando e come usarli.
Nota: questo post è anche disponibile sul blog di Claude
Prompt di esempio
Prima di addentrarci nei dettagli tecnici, vorrei iniziare con alcuni prompt di esempio per farti riflettere sulle possibilità offerte dai workflow:
- "Questo test fallisce circa 1 volta su 50. Imposta un workflow per riprodurlo, formulare teorie e testarle in modo avversario nei worktree /goal non fermarti finché una teoria non funziona."
- "Usando un workflow, esamina le mie ultime 50 sessioni e cerca le correzioni che continuo a fare, trasformando quelle ricorrenti in regole CLAUDE.md"
- "Usa un workflow per cercare in #incidents su Slack degli ultimi sei mesi e trovare cause radice ricorrenti per cui nessuno ha aperto un ticket."
- "Prendi il mio business plan ed esegui un workflow in cui diversi agenti lo smontano dal punto di vista di un investitore, un cliente e un concorrente."
- "Ecco una cartella con 80 curriculum, usa un workflow per classificarli per il ruolo backend e ricontrolla i primi dieci. Intervistami usando lo strumento AskUserQuestion per una rubrica."
- "Mi serve un nome per questo strumento CLI. Usa un workflow per fare brainstorming su molte opzioni e organizza un torneo per scegliere le prime 3."
- "Usa un workflow per rinominare il nostro modello User in Account ovunque."
- "Esamina la bozza del mio post del blog e, usando un workflow, verifica ogni affermazione tecnica confrontandola con il codebase, non voglio pubblicare nulla di sbagliato."
Come funzionano i workflow dinamici
I workflow dinamici eseguono un file JavaScript con alcune funzioni speciali che aiutano a generare e coordinare sotto-agenti:
I workflow dinamici includono anche funzioni JavaScript standard come JSON, Math e Array, per elaborare i dati.
È particolarmente utile sapere che i workflow dinamici possono decidere quali modelli un agente utilizza e se i sotto-agenti vengono eseguiti nel proprio worktree, consentendo a Claude di scegliere il livello di intelligenza e isolamento necessario.
Se un workflow viene interrotto, ad esempio da un'azione dell'utente o dalla chiusura del terminale, riprendere la sessione consentirà al workflow di ripartire da dove era stato interrotto.
Perché i workflow dinamici
Quando chiedi all'harness predefinito di Claude Code di eseguire un'attività, deve sia pianificare che eseguire nella stessa finestra di contesto. Per molte attività di programmazione, questo è molto efficace, ma a volte può fallire in attività lunghe, massicciamente parallele e/o altamente strutturate e avversarie.
Questo perché più a lungo Claude lavora su un'attività complessa in un'unica finestra di contesto, più diventa suscettibile ad alcuni specifici modelli di fallimento:
- Pigrizia agentica: si verifica quando Claude si ferma prima di completare un'attività particolarmente complessa e multiparte e dichiara il lavoro finito dopo un progresso parziale, ad esempio affrontando 20 dei 50 elementi in una revisione della sicurezza.
- Bias auto-preferenziale: si riferisce alla tendenza di Claude a preferire i propri risultati o scoperte, specialmente quando gli viene chiesto di verificarli o giudicarli secondo una rubrica.
- Deriva dell'obiettivo: si riferisce alla progressiva perdita di fedeltà all'obiettivo originale attraverso molti scambi, specialmente dopo la compattazione. Ogni passaggio di riepilogo comporta una perdita di informazioni, e dettagli come requisiti di casi limite o vincoli del tipo "non fare X" possono perdersi.
Creare un workflow aiuta a combattere questi problemi orchestrando Claude separati con le proprie finestre di contesto e obiettivi mirati e isolati.
Workflow dinamici vs statici
Potresti aver già creato un workflow statico usando Claude Agent SDK o claude -p per coordinare più istanze di Claude Code insieme.
Ma poiché i workflow statici devono funzionare per tutti i casi limite, di solito sono più generici. Con Claude Opus 4.8 e i workflow dinamici, Claude è ora abbastanza intelligente da scrivere un harness personalizzato su misura per il tuo caso d'uso.
Pattern utili quando si usano i workflow dinamici
Puoi iniziare a usare i workflow dinamici semplicemente chiedendo a Claude di crearne uno, oppure usando la parola chiave "ultracode" per assicurarti che Claude Code crei un workflow.
Ma costruire un modello mentale di come funzionano i workflow dinamici ti aiuterà a capire quando usarli e come potresti guidare Claude tramite i prompt.
Ci sono alcuni pattern comuni che Claude potrebbe utilizzare e combinare durante la creazione dei workflow:
Classifica e agisci
Usa un agente classificatore per decidere il tipo di attività, e quindi instrada verso diversi agenti o comportamenti in base all'attività. Oppure, usa un classificatore alla fine per determinare l'output.
Diramazione e sintesi
Dividi un'attività in molti passaggi più piccoli, esegui un agente su ogni passaggio e poi sintetizza i risultati. Questo è particolarmente utile quando ci sono un gran numero di passaggi piccoli, o quando ogni passaggio beneficia di una propria finestra di contesto pulita in modo che non interferiscano o si contaminino a vicenda. Il passaggio di sintesi è una barriera: attende che tutti gli agenti di diramazione finiscano, quindi unisce i loro output strutturati in un unico risultato.
Verifica avversaria
Per ogni agente generato, esegui un agente generato separato per verificare in modo avversario il suo output rispetto a una rubrica o a dei criteri.
Genera e filtra
Genera una serie di idee su un argomento e poi filtralle utilizzando una rubrica o mediante verifica, deduplica i duplicati e restituisci solo le idee di qualità più alta e testate.
Torneo
Invece di dividere il lavoro, fai competere gli agenti su di esso. Crea N agenti che tentano tutti lo stesso compito utilizzando approcci diversi. I prompt o i modelli giudicano poi i risultati in modo pairwise utilizzando un agente giudicante finché non hai un vincitore.
Ciclo fino al completamento
Per attività con una quantità di lavoro sconosciuta, esegui in loop la creazione di agenti finché non viene raggiunta una condizione di stop (nessuna nuova scoperta o nessun altro errore nei log) invece di un numero fisso di passaggi.
Casi d'uso
Pensa in modo creativo a quando e come chiedere a Claude Code di creare workflow dinamici. Ho scoperto che i workflow a volte sono ancora più utili per lavori non tecnici.
Migrazioni e refactoring
Bun è stato riscritto da Zig a Rust utilizzando i workflow. Puoi leggere di più su come è stato fatto nel thread X di Jarred.
La chiave è suddividere l'attività in una serie di passaggi su cui operare, ad esempio siti di chiamata, test falliti, moduli, ecc. Crea un sotto-agente per ogni correzione in un worktree per eseguire la correzione, poi fai rivedere in modo avversario da un altro agente e unisci le modifiche. Considera di dire all'agente di non usare comandi che richiedono molte risorse, in modo da poter parallelizzare al massimo senza esaurire le risorse della tua macchina.
Ricerca approfondita
Abbiamo pubblicato una skill di ricerca approfondita (/deep-research) all'interno di Claude Code che utilizza workflow dinamici. In particolare, dirama le ricerche web, recupera le fonti, verifica in modo avversario le loro affermazioni e sintetizza un rapporto con citazioni.
Ma puoi fare questo tipo di ricerca per più della semplice ricerca web. Ad esempio, chiedere a Claude di compilare un rapporto sullo stato dal contesto in Slack o di ricercare come funziona una funzionalità esplorando a fondo un codebase.
Verifica approfondita
D'altra parte, se hai un rapporto in cui vuoi controllare e verificare ogni affermazione fattuale a cui fa riferimento, potresti voler generare un workflow in cui un agente identifica tutte le affermazioni fattuali e poi crea un sotto-agente per controllare ciascuna in dettaglio. Potresti anche avere un agente di verifica che controlla il sotto-agente delle fonti per assicurarsi che la sua fonte sia di alta qualità.
Ordinamento
Potresti avere un elenco di elementi che desideri ordinare in base a una qualche misura qualitativa che ritieni che Claude Code sia bravo a valutare, ad esempio: ticket di supporto ordinati per gravità del bug. Ma se provi a ordinare 1000+ righe in un unico prompt, la qualità degrada e non entra nel contesto. Invece, esegui un torneo, una pipeline di agenti di confronto pairwise (il giudizio comparativo è più affidabile del punteggio assoluto) o classifica a bucket in parallelo e poi unisci. Ogni confronto è un agente a sé stante, quindi il ciclo deterministico mantiene il tabellone e solo l'ordine di esecuzione rimane nel contesto.
Memoria e aderenza alle regole
Se hai un insieme particolare di regole che Claude dimentica o con cui fa fatica, anche quando inserite nei CLAUDE.md, crea un workflow con un elenco di regole che devono essere controllate da agenti verificatori: un verificatore per regola. Creare un sub-agente con personalità scettica per rivedere le regole e assicurarsi che siano in linea aiuterà a evitare troppi falsi positivi.
Anche la direzione inversa funziona: analizza le tue sessioni recenti e i commenti di revisione del codice per trovare correzioni che continui a fare, raggruppale con agenti paralleli, verifica in modo avversario ogni candidato (questa regola avrebbe impedito un vero errore?), e poi distillare i sopravvissuti in un CLAUDE.md.
Analisi delle cause profonde
Il debugging funziona meglio quando si formulano diverse ipotesi indipendenti e le si testano, ma se stai usando una sola finestra di contesto, Claude può incorrere in bias auto-preferenziale.
Un workflow può prevenire strutturalmente questo problema creando agenti per generare ipotesi da prove separate. Ad esempio, agenti separati per log, file e dati. Ogni ipotesi può poi affrontare un panel di verificatori e confutatori.
Questo non vale solo per il codice. I workflow possono essere utilizzati per le vendite (perché le vendite sono calate a marzo?), l'ingegneria dei dati (perché questa pipeline è fallita?) o qualsiasi esercizio di post-mortem.
Triaging su larga scala
Ogni team ha una coda di supporto, segnalazioni di bug o qualche altro arretrato che non può essere completamente gestito dagli umani.
Un workflow di triage classifica ogni elemento, deduplica rispetto a ciò che è già tracciato e intraprende azioni. Questo potrebbe significare tentare la correzione o escalation a un utente umano.
Un pattern utile per i workflow di triage è la quarantena. Ciò comporta il divieto per gli agenti che leggono contenuti pubblici non attendibili di intraprendere azioni ad alta autorizzazione, che vengono invece eseguite dagli agenti incaricati di agire sulle informazioni.
Abbina i workflow di triage a /loop per far sì che Claude lo faccia in modo continuo.
Esplorazione e gusto
I workflow possono essere utili quando si esplorano diversi approcci a una soluzione, specialmente quando si basa sul gusto, come il design o la denominazione, e trarrebbe beneficio da una rubrica.
Prova a chiedere a Claude di esplorare molte soluzioni e fornisci a un agente di revisione una rubrica su come dovrebbe essere una buona soluzione. L'attività è completa quando l'agente di revisione ritiene di aver soddisfatto i criteri. Le soluzioni possono anche essere ordinate o selezionate tramite un torneo basato sulla rubrica.
Valutazioni
Puoi eseguire valutazioni leggere per attività particolari creando agenti separati in un worktree e poi creando agenti di confronto per confrontare e valutare gli output specifici rispetto a una rubrica. Ad esempio, valutare e poi perfezionare una skill che hai creato rispetto a criteri specifici.
Instradamento del modello e dell'intelligenza
Crea un agente classificatore ottimizzato per le tue attività che decide quale modello utilizzare. Questo può essere utile quando la tua attività richiederà molte chiamate di strumenti e condurre ricerche prima dell'esecuzione può identificare il modello migliore per il lavoro.
Ad esempio, il modello migliore per l'attività "spiega come funziona il modulo di autenticazione" dipende da quanti file ci sono nel modulo di autenticazione e dalla forma del codebase. Un agente classificatore può fare questa ricerca e poi instradare a Sonnet o Opus in base alla complessità prevista dell'attività.
Quando non usare i workflow dinamici
I workflow sono nuovi. Sebbene ci siano molti casi d'uso in cui produrranno risultati eccezionali, non sono necessari per ogni attività e potrebbero finire per utilizzare significativamente più token.
È meglio usare i workflow in modo creativo per spingere Claude Code in modi che non hai mai fatto prima. Per le attività di programmazione regolari, prova a chiederti: ha davvero bisogno di più potenza di calcolo? Ad esempio, la maggior parte delle attività di programmazione tradizionali non ha bisogno di un panel di 5 revisori.
Consigli per creare workflow dinamici
Scrittura dei prompt
Una scrittura dettagliata dei prompt, utilizzando le tecniche specifiche descritte sopra, produce i migliori risultati per i workflow dinamici.
I workflow non servono solo per attività grandi. Puoi chiedere al modello di usare un "workflow rapido". Ad esempio, puoi creare una rapida revisione avversaria di un'ipotesi.
Combina con /goal e /loop
Quando utilizzi workflow che possono essere ripetuti, ad esempio triage, ricerca o verifica, abbinali a /loop per essere eseguiti a intervalli regolari e a /goal per impostare un requisito di completamento rigido.
Budget di utilizzo token
Puoi impostare budget di utilizzo token espliciti per i workflow dinamici per limitare quanti token utilizza un'attività. Puoi chiedere con un budget come: "usa 10k token", che imposterà il limite.
Salvare e condividere i workflow dinamici
Puoi salvare i workflow premendo "s" nel menu del workflow. Puoi inserirli in ~/.claude/workflows o distribuirli tramite una skill.
Per condividerli tramite una skill, inserisci i tuoi file JavaScript del workflow nella cartella della skill e fai riferimento a essi in SKILL.MD. Per consentire una maggiore flessibilità, potresti voler chiedere a Claude di considerare i workflow nella skill come un modello invece che uno script da eseguire alla lettera.
Un mondo completamente nuovo
I workflow sono un nuovo modo utile per estendere Claude Code. Ti incoraggio a considerarlo come un punto di partenza; c'è ancora molto da scoprire su come usarli al meglio. Facci sapere cosa trovi.
Thariq Shihipar e Sid Bidasaria (@sidbid) sono membri dello staff tecnico di Anthropic e lavorano su Claude Code.
