--- title: "Sub-agent, squadre d'agenti e workflow" description: "Usare efficacemente i sub-agent e le squadre, con l'analogia del labirinto per una delega pulita, senza il context cliff ne i costi che sfuggono" type: "lesson" locale: "it" course: "Claude Code Mastery - Diventare power user" number: "2.5" canonical: "https://agenticschool.dev/it/corsi/claude-code-mastery/sub-agents-agent-teams-and-workflows" datePublished: "2026-06-12" dateModified: "2026-06-12" --- # Sub-agent, squadre d'agenti e workflow - Course: Claude Code Mastery - Diventare power user - Lesson: 2.5 - Duration: 25 min - Level: fortgeschritten - Status: published - Canonical URL: https://agenticschool.dev/it/corsi/claude-code-mastery/sub-agents-agent-teams-and-workflows - Locale: it > Usare efficacemente i sub-agent e le squadre, con l'analogia del labirinto per una delega pulita, senza il context cliff ne i costi che sfuggono ## Summary Un agente puo tenere solo tanta roba nel contesto prima che la qualita cada dal cliff. I sub-agent ti lasciano delegare un compito autonomo a un agente fresco dal contesto pulito, il che tiene l'agente principale affilato. Questa lezione copre la motivazione del context cliff, l'analogia del labirinto per la delega, quando lanciare i sub-agent in sequenza contro in parallelo e come impedire a una squadra d'agenti di moltiplicare in silenzio la tua fattura. ## What you learn - Perche i sub-agent esistono: proteggere il context window principale dal performance cliff - L'analogia del labirinto: un sub-agent esplora un ramo e riporta solo la conclusione - Sequenziale contro parallelo, e impedire ai workflow multi-agente di moltiplicare i tuoi costi ## Panoramica Un sub-agent e un agente fresco che lanci per un compito delimitato. Fa il lavoro nel suo context window pulito e riporta solo il risultato, cosicche il tuo agente principale resta focalizzato e non raggiunge mai il performance cliff per il fatto di portare tutto in una volta. Questa lezione spiega perche cio conta, ti da l'analogia del labirinto che rende la buona delega ovvia, e copre le decisioni pratiche - sequenziale contro parallelo, quale modello, come delimitare il compito - che decidono se una squadra aiuta o si limita a bruciare denaro. ## Cosa imparerai Imparerai perche i sub-agent esistono e quale problema di context cliff risolvono, l'analogia del labirinto per delimitare il lavoro delegato, come scrivere un brief pulito per un sub-agent affinche riporti una conclusione netta piuttosto che un guazzabuglio, quando lanciare gli agenti in sequenza contro in parallelo e come tenere i costi in vista perche una squadra d'agenti non gonfi in silenzio la tua fattura di un multiplo. ## Prerequisiti La lezione su token, contesto e performance cliff del Corso 1 e un workflow single-agent confortevole. Il multi-agente paga solo una volta che hai davvero padroneggiato un agente, perche qui tutto ruota attorno alla gestione dei limiti che hai incontrato per la prima volta nel Corso 1 - ora su piu agenti invece di uno. ## Il problema Dai al tuo agente un grosso compito. A meta strada, il suo context window e stipato di contenuti di file, di output di comandi, di vicoli ciechi che ha esplorato e di cronologia di conversazione. Il performance cliff colpisce: comincia a dimenticare l'obiettivo iniziale, a contraddire decisioni precedenti e a diventare confuso su dettagli limpidi un'ora fa. Il lavoro della seconda meta e peggiore di quello della prima, non perche il modello sia peggiorato, ma perche la sua scrivania e ingombra. Non puoi correggere questo con un prompt migliore. La finestra e semplicemente piena del rumore che il compito ha generato lungo la strada. ## Perche i sub-agent esistono Un sub-agent risolve il problema della scrivania ingombra facendo l'esplorazione disordinata altrove. Lanci un agente fresco dal contesto vuoto, gli dai un compito autonomo, e si fa strada in tutta la lettura di file, l'esecuzione di comandi e i vicoli ciechi nella sua finestra. Quando ha finito, riporta solo la conclusione al tuo agente principale. Tutto quel rumore - i dodici file che ha letto, gli approcci falliti, l'output grezzo dei comandi - resta nel contesto del sub-agent e non tocca mai il tuo. La scrivania del tuo agente principale resta pulita, quindi resta affilato per tutto il compito. E tutto il punto: i sub-agent sono anzitutto uno strumento di gestione di contesto, uno strumento di parallelismo solo dopo. ## L'analogia del labirinto Immagina il tuo agente principale che avanza in un labirinto verso un obiettivo, tenendo il filo che segna il cammino del ritorno. Ogni corridoio laterale che esplora lui stesso rischia di fargli perdere il posto e dimenticare la via. Immagina ora che possa invece mandare un esploratore in un corridoio laterale. L'esploratore esplora tutto il ramo - legge tutto, incontra i vicoli ciechi, trova la risposta - e torna a riportare una sola frase: "questo corridoio porta alla stanza del tesoro, prendi la seconda a sinistra". L'agente principale non ha mai lasciato il cammino principale, mai perso il filo e ha guadagnato esattamente il sapere di cui aveva bisogno. Questo e un sub-agent. Deleghi un ramo del lavoro, il sub-agent assorbe tutto il disordine dell'esplorazione, e il tuo contesto principale riceve solo la conclusione pulita. - I buoni compiti da sub-agent sono autonomi: "trova quale file definisce la middleware di auth e riassumi come funziona". - Il sub-agent fa tutto il lavoro rumoroso: leggere molti file, lanciare ricerche, provare approcci. - Riporta una conclusione, non una trascrizione: un riassunto netto a cui l'agente principale puo reagire. - Il tuo contesto principale cresce solo di questa conclusione, non di tutto cio che il sub-agent ha toccato. ## Sequenziale contro parallelo Una volta che hai dei sub-agent, puoi lanciarli in due modi, e scegliere bene conta per la correttezza e i costi. Lanciali in sequenza quando ogni passo dipende dal precedente - esplorare, poi costruire a partire da cio che e stato trovato, poi testare a partire dal build. L'ordine e la logica. Lanciali in parallelo quando i compiti sono davvero indipendenti: riassumere cinque file distinti, o ispezionare tre sottosistemi non collegati. Il parallelo e piu veloce, ma sicuro solo se non c'e stato condiviso su cui gli agenti inciamperebbero. Il default onesto e il sequenziale: piu facile da ragionare, piu facile da debuggare, e la maggior parte del vero lavoro ha dipendenze tra i passi. Afferra il parallelo solo quando l'indipendenza e ovvia. - Sequenziale: ogni passo ha bisogno del risultato del precedente. Piu facile da ragionare e debuggare. Il default sicuro. - Parallelo: i compiti sono totalmente indipendenti senza stato condiviso. Piu veloce, ma corretto solo se davvero indipendenti. - Nel dubbio, sequenziale - un cattivo taglio parallelo causa bug sottili, difficili da rintracciare. - Nota che gli assiomi CLAUDE.md di questo preciso progetto esigono un lavoro di sub-agent sequenziale per esattamente questa ragione. ## Controllo dei costi Ogni agente costa token, e una squadra moltiplica cio in fretta. Tre sub-agent piu un agente principale sono quattro context window riempiti e fatturati, e se li lanci senza cura, la fattura sale in silenzio. Tre abitudini tengono cio ragionevole. Primo, lancia un sub-agent solo se il focus che compra vale la spesa - un unico agente fa molto lavoro bene, e non tutto va delegato. Secondo, adatta il modello al compito: una sotto-attivita ristretta di estrazione o di riassunto puo girare su un modello piccolo ed economico, mentre l'agente principale ne usa uno potente per il reasoning. Terzo, delimita strettamente i compiti dei sub-agent perche finiscano in fretta senza divagare, perche un brief vago trasforma un esploratore economico in un esploratore caro. L'obiettivo e comprare focus dove il focus vale la pena, non guidare un esercito permanente di agenti. ## Errori frequenti I costosi: lanciare sub-agent per un lavoro che un unico agente farebbe bene, cosicche paghi una coordinazione non necessaria; lanciare in parallelo compiti che condividono segretamente stato e si corrompono a vicenda; dare a un sub-agent un brief vago, cosicche riporta una trascrizione pletorica che ri-inquina il tuo contesto principale invece di una conclusione pulita; e usare un modello di punta per ogni sotto-attivita quando uno economico basterebbe. Delega deliberatamente, delimita strettamente e scegli il modello per job. ## ROI business I sub-agent sono il modo di far scalare la quantita di vero lavoro che un workflow agentico puo abbattere, senza che la qualita crolli al cliff. Una squadra che delega bene puo prendere compiti molto piu grandi di cio che un unico context window potrebbe mai tenere, mantenendo al tempo stesso l'output finale affilato, perche l'agente principale non annega mai nei dettagli. Fatto con disciplina - delegare solo se ne vale la pena, modelli economici per i job ristretti, delimitazioni strette - ottieni il rendimento di una squadra per una frazione di cio che costerebbe una spesa multi-agente senza cura. Per un fondatore, e la differenza tra un agente che aiuta su compiti e un sistema agentico che pilota progetti interi. ## Checklist Sei pronto ad andare avanti quando ognuno di questi punti e vero. La prossima lezione va in profondita nella gestione del contesto su uno o piu agenti. - Sai spiegare perche un sub-agent protegge il context window principale. - Sai usare l'analogia del labirinto per decidere cosa fa un buon compito delegato. - Sai quando lanciare i sub-agent in sequenza contro in parallelo e perche il sequenziale e il default. - Hai tre abitudini concrete per tenere i costi multi-agente sotto controllo. ## Risorse Tieni nei preferiti la documentazione di Claude Code sui sub-agent per il modo aggiornato di definirli e invocarli, incluse le configurazioni di sub-agent su misura. La lezione di scelta di modello del Corso 1 e il tuo riferimento per adattare un modello economico a una sotto-attivita ristretta. Il tuo CLAUDE.md e il posto giusto per fissare le regole di squadra - sequenziale per default, quando delegare - perche l'agente le applichi automaticamente. ## La tua missione Prendi un compito che gonfia di solito il tuo contesto - qualcosa che deve esplorare piu file prima di agire. Fallo girare due volte: una volta con un unico agente che fa tutto, e una volta lasciando che l'agente lanci un sub-agent che esplora e riporta una conclusione prima di agire. Nota quanto la sessione principale resta piu pulita la seconda volta. E il cliff gestito invece che colpito. ## Prossima lezione Gestire il contesto su uno o piu agenti e un mestiere a se stante. La prossima lezione va in profondita sulle leve: perche l'auto-compaction nuoce in silenzio, come re-iniettare i tuoi obiettivi dopo, scrivere documenti di passaggio di consegne, quando reimpostare completamente una chat e adattare il thinking effort al compito. ## Transcript Un agente puo tenere solo tanta roba nel contesto prima che la qualita cada dal cliff. I sub-agent ti lasciano delegare un compito autonomo a un agente fresco dal contesto pulito, il che tiene l'agente principale affilato. Questa lezione copre la motivazione del context cliff, l'analogia del labirinto per la delega, quando lanciare i sub-agent in sequenza contro in parallelo e come impedire a una squadra d'agenti di moltiplicare in silenzio la tua fattura.