Iniziare con i cicli in Claude Code

Ecco la traduzione in italiano del testo fornito, seguendo tutte le linee guida specificate.

Si parla molto, in questo momento, di "progettare cicli" invece di fare semplici prompt all'agente di coding. Se passi un po' di tempo su X a cercare di capire cosa sia esattamente un ciclo, ti imbatterai in risposte molto diverse tra loro.

Nel team di Claude Code, definiamo i cicli come agenti che ripetono cicli di lavoro fino al raggiungimento di una condizione di arresto. Classifichiamo diversi tipi di cicli in base a:

• Come vengono attivati
• Come vengono fermati
• Quale primitiva di Claude Code viene utilizzata
• Per quale tipo di attività sono più adatti.

Vedremo i principali tipi di ciclo, quando usarli e come mantenere la qualità del codice gestendo al contempo il consumo di token. Non tutte le attività richiedono cicli complessi; inizia con la soluzione più semplice e usa questi pattern in modo selettivo.

Cicli basati sui turni

• Attivati da: Un prompt dell'utente.
• Criterio di arresto: Claude stabilisce di aver completato l'attività o di aver bisogno di ulteriore contesto.
• Ideali per: Attività brevi che non fanno parte di un processo o una pianificazione regolare.
• Utilizzo gestito tramite: Scrivere prompt specifici e migliorare la verifica usando le skill per ridurre il numero di turni.‍

Ogni prompt che invii avvia un ciclo manuale in cui tu dirigi ogni turno. Claude raccoglie il contesto, agisce, controlla il suo lavoro, ripete se necessario e risponde. Chiamiamo questo processo il ciclo agentico.

Ad esempio, chiedi a Claude di creare un pulsante "Mi piace". Legge il tuo codice, apporta la modifica, esegue i test e restituisce qualcosa che crede funzioni. Tu poi controlli manualmente il lavoro e scrivi il prompt successivo.

Puoi migliorare la fase di verifica codificando i tuoi passaggi manuali in un file SKILL.md in modo che Claude possa controllare più autonomamente il suo lavoro, dall'inizio alla fine. Questo dovrebbe includere strumenti o connettori che permettano a Claude di vedere, misurare o interagire con il risultato. Più i controlli sono quantitativi, più è facile per Claude auto-verificarsi.

Ad esempio, nel tuo file SKILL.md potresti specificare:

1---
2name: verify-frontend-change
3description: Verifica qualsiasi modifica UI dall'inizio alla fine prima di dichiararla completata.
4---
5
6# Verifica delle modifiche frontend
7Non dichiarare mai una modifica UI come completata basandoti solo su una modifica al codice riuscita. Verificala come farebbe un revisore umano:
8
91. Avvia il server di sviluppo e apri la pagina modificata nel browser.
10
112. Interagisci direttamente con la modifica. Per un nuovo controllo (pulsante, campo di input, interruttore): cliccaci sopra, conferma il cambiamento di stato previsto e fai uno screenshot prima/dopo.
12
133. Controlla la console del browser: zero nuovi errori o avvisi.
14
154. Usa l'MCP di Chrome Devtools, esegui una traccia delle performance e verifica i Core Web Vitals.
16
17Se un qualsiasi passaggio fallisce, correggi il problema e ripeti dal passaggio 1 — non restituire un lavoro verificato solo parzialmente.

Ciclo basato sugli obiettivi (/goal)

• Attivato da: Un prompt manuale in tempo reale.
• Criterio di arresto: Obiettivo raggiunto OPPURE numero massimo di turni raggiunto.
• Ideale per: Attività che hanno criteri di uscita verificabili.
• Utilizzo gestito tramite: Impostare criteri di completamento specifici e limiti di turni espliciti, "fermati dopo 5 tentativi."

A volte, un singolo turno non è sufficiente, specialmente per attività più complesse. Gli agenti danno il meglio quando possono iterare. Puoi estendere il tempo in cui Claude continua a iterare definendo come si presenta il "fatto" con /goal.

Quando definisci i criteri di successo, Claude non deve determinare cosa sia "abbastanza buono" e terminare il ciclo prematuramente. Ogni volta che Claude cerca di fermarsi, un modello valutatore controlla la tua condizione e lo rimanda al lavoro finché l'obiettivo non viene raggiunto o fino al numero di turni che hai definito.

Ecco perché i criteri deterministici, come il numero di test superati o il raggiungimento di una certa soglia di punteggio, sono così efficaci.

Ad esempio:

1/goal porta il punteggio Lighthouse della homepage a 90 o superiore, fermati dopo 5 tentativi.

Ciclo basato sul tempo (/loop e /schedule)

• Attivato da: Un intervallo di tempo specificato.
• Criterio di arresto: Lo annulli tu, oppure il lavoro viene completato (la PR viene unita, la coda si svuota).
• Ideale per: Lavori ricorrenti o per interfacciarsi con ambienti/sistemi esterni.
• Utilizzo gestito tramite: Impostare intervalli più lunghi o reagire in base agli eventi piuttosto che al tempo.

Alcuni lavori agentici sono ricorrenti: l'attività rimane la stessa e cambiano solo gli input. Ad esempio, riassumere i messaggi di Slack ogni mattina. Altri lavori dipendono da sistemi esterni, e un modo semplice per interfacciarsi con uno di essi è controllarlo a intervalli regolari e reagire a ciò che è cambiato. Ad esempio, una PR che potrebbe ricevere revisioni del codice o far fallire la CI.

Per questi casi, puoi attivare l'esecuzione di Claude con \/loop`` che riesegue un prompt a intervalli regolari. Ad esempio:

1/loop 5m controlla la mia PR, rispondi ai commenti di revisione e correggi la CI fallita

\/loop` viene eseguito sul tuo computer, quindi se lo spegni, si ferma. Puoi spostare il ciclo sul cloud creando una routine con \/schedule\`.

Cicli proattivi

• Attivati da: Un evento o una pianificazione, senza un umano in tempo reale.
• Criterio di arresto: Ogni attività termina quando il suo obiettivo viene raggiunto. La routine stessa viene eseguita finché non la disattivi.
• Ideali per: Flussi ricorrenti di lavoro ben definito: segnalazioni di bug, triage dei problemi, migrazioni, aggiornamenti delle dipendenze, ecc.
• Utilizzo gestito tramite: Instradare le routine verso modelli più piccoli e veloci e usare il modello più capace per le decisioni critiche.

Le primitive sopra, insieme ad altre funzionalità di Claude Code come la modalità automatica e i flussi di lavoro dinamici (anteprima di ricerca), possono essere combinate in un ciclo per lavori di lunga durata.

Ad esempio, per gestire il feedback in arrivo, puoi utilizzare:

1. `/schedule` (anteprima di ricerca) per eseguire una routine che controlla la presenza di nuove segnalazioni
2. `/goal` per definire come si presenta il "fatto" e le skill per documentare come verificarlo
3. Flussi di lavoro dinamici per orchestrare agenti che triano ogni segnalazione, la risolvono e ne revisionano la correzione
4. Modalità automatica in modo che la routine venga eseguita senza fermarsi a chiedere il permesso

Mettendo tutto insieme, un prompt potrebbe essere simile a questo:

1/schedule ogni ora: controlla il canale project-feedback per le segnalazioni di bug. /goal: non fermarti finché ogni segnalazione trovata in questa esecuzione non è stata triata, gestita e a cui è stata data risposta. Quando correggi un bug, usa un flusso di lavoro per esplorare tre soluzioni in worktree paralleli e fai in modo che un giudice le esamini in modo avversariale.

Mantenere la qualità del codice

La qualità dell'output di un ciclo dipende dal sistema che lo circonda. Quando progetti il sistema:

• Mantieni pulito il codebase stesso: Claude segue i pattern e le convenzioni già esistenti nel tuo codebase.
• Fornisci a Claude un modo per verificare il suo lavoro: Codifica ciò che è "buono" per te e il tuo team con le skill.
• Rendi la documentazione facilmente accessibile: La documentazione di framework e librerie contiene le best practice aggiornate.
• Usa un secondo agente per le revisioni del codice: Un revisore con contesto fresco è meno prevenuto e non influenzato dal ragionamento dell'agente principale. Puoi usare la skill integrata \/code-review\ o Code Review per Github.

Quando un risultato individuale non soddisfa lo standard, non limitarti a correggere il singolo problema, cerca di codificarlo per migliorare il sistema per tutte le iterazioni future.

Gestire il consumo di token

Per gestire il consumo di token, i cicli dovrebbero avere confini chiari:

• Scegli la primitiva e il modello giusti per il lavoro: Le attività più piccole non hanno bisogno di più agenti o cicli. Alcune attività possono utilizzare modelli più economici e veloci.
• Definisci criteri di successo e di arresto chiari: Sii specifico su come si presenta il "fatto" in modo che Claude possa arrivare alla soluzione prima (ma non troppo presto).
• Fai una prova prima di un'esecuzione su larga scala: I flussi di lavoro dinamici possono generare centinaia di agenti. Valuta l'utilizzo prima su una parte più piccola del lavoro.
• Usa script per lavori deterministici: Eseguire uno script è più economico che ragionare attraverso i passaggi. Ad esempio, una skill per PDF può includere uno script per la compilazione di moduli che Claude esegue ogni volta, invece di derivare nuovamente il codice.
• Non eseguire le routine più spesso del necessario: Abbina l'intervallo alla frequenza con cui la cosa che stai monitorando cambia.
• Controlla l'utilizzo: Il comando \/usage\ suddivide l'utilizzo recente per skill, subagenti e MCP, \/goal\ senza argomenti mostra il numero di turni e il consumo di token finora, \/workflows\ mostra il consumo di token di ogni agente e puoi fermare un agente in qualsiasi momento.

Per iniziare

Per riassumere:

Ciclo

Deleghi

Usalo quando

Ricorri a

Basato sui turni

Il controllo

Stai esplorando o decidendo

Skill di verifica personalizzate

Basato sugli obiettivi

La condizione di arresto

Sai come si presenta il "fatto"

/goal

Basato sul tempo

L'attivazione

Il lavoro avviene al di fuori del tuo progetto secondo una pianificazione

/loop

,

/schedule

Proattivo

Il prompt

Il lavoro è ricorrente e ben definito

Tutti i precedenti e flussi di lavoro dinamici

Per iniziare con i cicli, guarda al lavoro che già svolgi. Scegli un'attività in cui sei tu il collo di bottiglia e chiediti quale parte potresti delegare: puoi scrivere il controllo di verifica? L'obiettivo è abbastanza chiaro? Il lavoro arriva secondo una pianificazione?

Una volta che hai un'idea, esegui il ciclo, osserva i risultati, come dove si blocca o dove eccede, e non aver paura di iterare.

Per maggiori informazioni, leggi la documentazione di Claude Code su esecuzione di agenti in parallelo, così come le pagine su loop, schedule, goal e flussi di lavoro dinamici.

Questo articolo è stato scritto da @delba_oliveira