Non perdere il tuo lavoro con /clear — scopri session-handoff

Se hai mai terminato una lunga sessione di debugging, premuto /clear e poi, una settimana dopo, desiderato ricordare quale delle tre opzioni di database il team aveva scartato — questo è per te.

Il problema è piccolo ma costoso. Lavorare con un agente AI su un progetto reale produce uno strato di conoscenza che non vive altrove. Perché una certa libreria è stata rifiutata. Quale ambiente di staging è guasto. Cosa intendeva davvero l’utente con "the gate". Non è nel codice. Non è in git. È nella conversazione. E la conversazione sta per essere cancellata.

Il test di salvataggio

session-handoff è una piccola Agent Skill che viene eseguita prima che tu cancelli. Analizza la sessione alla ricerca di fatti e applica una domanda decisiva:

"Rileggere il repository recupererebbe questo?"

Se sì, lascialo perdere — il codice è la fonte di verità. Se no, potrebbe valere la pena salvarlo. Questa singola euristica elimina circa l’80% dei falsi salvataggi e impedisce al file di memoria a lungo termine di trasformarsi in rumore.

Come funziona in pratica

Il flusso è di sette passaggi, ma l’esperienza è di due: digita un trigger come "checkpoint before clearing," rivedi cosa verrebbe salvato, approva. La skill scrive quindi voci markdown strutturate — user per ruolo e ambiente, feedback per regole operative, project per obiettivi e decisioni, reference per puntatori a sistemi esterni — e aggiorna un file indice di una riga così le sessioni future lo caricano in modo economico.

Due dettagli tecnici che lo rendono davvero utilizzabile:

• Normalizzazione della data. "Thursday" viene convertito in 2026-05-21 al momento dell’estrazione, così la voce continua ad avere senso tra tre mesi.
• Struttura Why / How. Ogni voce di feedback o project include il motivo (spesso un incidente passato) e quando si applica la regola. Questo permette al tuo futuro io di valutare i casi limite invece di seguire ciecamente la nota.

Chi ne ha bisogno

Se il tuo lavoro tocca migrazioni di lunga durata, rollout con più stakeholder o qualsiasi cosa in cui gli accordi verbali sopravvivono alla conversazione che li ha generati — questa è la cosa giusta. Lead di piattaforma, SRE, contract engineer che passano il lavoro ad altri. Non perché sia ingegnosa. Perché l’alternativa è ricostruire ciò che già sapevi, male, tre settimane troppo tardi.

Il repository è aperto e la skill è abbastanza piccola da poterla leggere in un’unica seduta:

👉 github.com/andreab67/agent-skills/blob/main/session-handoff/SKILL.md