Iniziate in dieci minuti

Tutto ciò che è stato trattato prima di questo capitolo riguardava il caso, lo schema e la facilitazione. Questo capitolo è dedicato alla pratica. Tra dieci minuti potrete disporre delle competenze necessarie, di uno stimolo che si attiva senza che nessuno se ne accorga e di un quadro chiaro di ciò che accadrà dopo che le prime cinque voci saranno state inserite.

Installare le due competenze

Il progetto viene distribuito sotto forma di due competenze 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 riferimenti documentali, 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 retro: gli attriti ricorrenti ordinati per frequenza e costo, la distribuzione delle cause alla radice, l’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 dallo strumento contenuto nel repository presenta lo stesso schema (stessa voce in quattro parti, stesse etichette fisse, stesso principio «nessun risultato senza una soluzione») per 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 competenze è probabilistica: se alla fine della sessione nulla fa scattare il retro, 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. Sceglietene almeno uno; due sono meglio.

Un hook di avvio della sessione. Aggiunga unSessionStarthook che.claude/settings.jsoninserisca 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/retrocomando. Da creare.claude/commands/retro.mdcon una breve istruzione per eseguire la skill nella sessione corrente, esattamente come specificato. Digitando/retroil comando alla 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 da copiare e incollare per tutti e tre sono disponibili nel repository SETUP.md.

Come apparirà la sua prima voce

Eseguite una sessione con la skill attiva. 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 riscontro, una prova che comporta 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 vostro lavoro che voi conoscevate solo in parte e che non avevate mai messo per iscritto.

Dopo cinque proposte, si proceda alla presentazione del brief

ai-retro-briefUna sola voce è un aneddoto; cinque sono sufficienti perché gli schemi ricorrenti inizino ad assumere un significato. Dopo una o due settimane di lavoro normale, esegua il comando. Il programma legge ogni voce, classifica gli attriti ricorrenti, indica chiaramente quale gruppo di cause principali 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; ci 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 vostro team gestisce le proprie retrospettive su TeamRetro, l’agente può preparare le proprie raccomandazioni sulla base del log e, previa vostra conferma per ciascuna voce, archiviarle tramite il server MCP di TeamRetro: voci in sospeso in coda per la vostra prossima retrospettiva, oppure azioni da intraprendere quando una correzione ha già un responsabile. Ogni voce pubblicata è preceduta dal prefisso [AI retro], in modo che i partecipanti alla riunione possano vedere chi 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), la pagina principale della 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 di 10 minuti dell’intera guida.