Iniziate in dieci minuti

Tutto ciò che è stato trattato prima di questo capitolo riguardava il caso, lo schema e la facilitazione. Questo capitolo riguarda la messa in pratica. Tra dieci minuti potrete disporre delle competenze necessarie, di uno stimolo che si attiva senza che nessuno se ne renda conto e di un quadro chiaro di ciò che accade dopo che le prime cinque voci sono state inserite.

Installare le due competenze

Il progetto viene distribuito come due skill gratuite nel repository TeamRetro-skills, open source con licenza MIT:

• ai-session-retro**** redige la voce di chiusura della sessione: la retrospettiva in quattro parti, corredata di prove, descritta nella presente guida, con un’etichetta fissa indicante la causa principale per ogni elemento di attrito e una soluzione delle dimensioni di un biglietto per ogni risultato emerso.
• ai-retro-brief**** legge le voci accumulate e sintetizza il riassunto di una pagina da presentare prima del retrospettivo: gli attriti ricorrenti ordinati per frequenza e costo, la distribuzione delle cause alla radice, l’eventuale effettiva adozione delle soluzioni adottate in passato e tre azioni raccomandate.

Clonate il repository e inserite le competenze nella vostra configurazione di Claude Code. Non utilizzate Claude Code? Il pacchetto di prompt indipendente dal tool presente nel repository mantiene lo stesso schema (stessa voce in quattro parti, stesse etichette fisse, stesso principio “nessun risultato senza correzione”) su Cursor, GitHub Copilot o qualsiasi altro agente a cui sia possibile fornire un prompt di sistema.

Rendere il trigger deterministico

Ecco l’unico passaggio di configurazione che i team tendono a tralasciare e di cui poi si pentono. L’attivazione delle abilità è probabilistica: se nulla innesca il retro alla fine della sessione, il log rimane silenziosamente a secco e il vostro primo resoconto non avrà mai abbastanza elementi da riportare. La soluzione consiste nell’aggiungere un trigger deterministico. Scegliete almeno uno di questi; due sono meglio.

Un hook all’inizio della sessione. Aggiunga un hookSessionStart .claude/settings.jsonche inserisca una riga di contesto: «al termine naturale di una sessione significativa, esegua la skill ai-session-retro e salvi la voce». È un po’ grossolano (si attiva anche per sessioni di due minuti), ma è l’unico trigger che non dipende dal fatto che nessuno ricordi nulla.

Un comando/retro. Da creare con.claude/commands/retro.md una breve istruzione per eseguire la skill nella sessione corrente, esattamente come specificato. Digitando il comando /retroalla fine di un ramo di funzionalità o di un turno di triage, lo si attiva su richiesta. Una volta digitato, il funzionamento è deterministico; l’anello debole è la memoria umana, pertanto si consiglia di abbinarlo a una delle altre opzioni.

Una linea guida convenzionale. Una frase contenuta nel file di contesto dell’ambito (CLAUDE.md / AGENTS.md) o, per gli ambiti non relativi al codice, nelle procedure operative standard (SOP) del team: «Concludere ogni sessione significativa assistita dall’IA eseguendo ai-session-retro e salvando la voce». Nessuna infrastruttura; consideratela come il livello normativo, non come il fattore scatenante.

I frammenti di codice esatti, pronti per essere copiati e incollati, per tutti e tre si trovano nel file . del repositorySETUP.md.

Come apparirà la sua prima voce

Esegua una sessione con la skill attivata. Al termine, l’agente scriverà qualcosa del genere: un concetto concreto dal punto di vista del marketing, non della programmazione, per sottolineare che questa pratica non è riservata esclusivamente agli sviluppatori:

# 2026-07-16 — Monthly ads account review

**Session size:** ~25 turns, 1 deliverable
**Outcome:** shipped

## Friction
- **[missing-context]** The brief didn't say the French campaigns were
  deliberately paused for Q3; ~40 min (est.) auditing a "broken"
  campaign that was fine.
  → Fix (altitude: process): add campaign-status flags to the monthly
    brief template

## Do this first
Campaign-status flags in the brief template — kills the largest single
time sink this month.

Un’etichetta per ogni risultato, una prova che ha un costo, una soluzione su misura per diventare un ticket. Quella prima lettura è solitamente il momento in cui la pratica acquista senso: l’agente individua un aspetto del Suo lavoro che Lei in parte conosceva ma che non aveva mai messo per iscritto.

Dopo cinque proposte, si proceda alla lettura del brief

Una sola voce costituisce un aneddoto; cinque sono necessarie affinché gli schemi inizino ad assumere un significato. Dopo una o due settimane di lavoro normale, esegua il comandoai-retro-brief. Il programma legge ogni voce, classifica gli attriti ricorrenti, indica chiaramente quale gruppo di cause alla radice prevale (briefing, documentazione, materiale di lavoro, strumenti o l’agente stesso) e verifica se le soluzioni proposte nelle voci precedenti siano state effettivamente adottate. Il risultato è una pagina, redatta per le persone che partecipano a una retrospettiva.

A questo punto chiuda il ciclo; vi sono due modi per farlo:

• Con qualsiasi strumento retro. Il brief è semplicemente un documento. Leggetelo prima della riunione, aggiungete uno o due punti principali alla bacheca che utilizzate, post-it compresi. L’intero processo funziona in questo modo, dall’inizio alla fine, senza TeamRetro né alcun altro prodotto specifico.
• Con TeamRetro, l’agente pubblica autonomamente i propri post. Se il Suo team gestisce le proprie retrospettive su TeamRetro, l’agente può preparare le proprie raccomandazioni sulla base del registro e, previa Sua conferma per ciascuna voce, archiviarle tramite il server MCP di TeamRetro: voci in sospeso in coda per la Sua prossima retrospettiva, oppure azioni da intraprendere quando una correzione ha già un responsabile. Ogni voce pubblicata è preceduta dal prefisso [AI retro], in modo che la sala possa vedere quale partecipante l’ha sollevata: le osservazioni dell’agente arrivano sulla bacheca come suo contributo diretto, anziché essere da voi riportate di seconda mano.

Dove recarsi successivamente

Questo è l’intero ciclo: installazione, attivazione, cinque voci, sintesi, retrospettiva. Se desiderate rivedere il ragionamento alla base di qualsiasi fase (le etichette, le regole di onestà, la facilitazione), il centro guida rimanda a ogni capitolo. E se state inviando questo documento a un collega che non leggerà sei capitoli, inviategli come raccogliere feedback dai vostri agenti IA, la versione da 10 minuti dell’intera guida.