Caso di studio · Routine
Diagnosticare e riparare un sistema che non comunica più
Mattoni che funzionavano ciascuno per conto proprio, ma i cui collegamenti si erano spezzati senza rumore. Quattro rilevazioni, una mappa, un passaggio su tutte le frecce, correzioni ricontrollate alla fonte, poi una sorveglianza che constata senza riparare.
Idea
Quale problema, in una frase?
Constatare che i mattoni non comunicano più
Ogni mattone funzionava da solo: lo smistamento della posta, il cruscotto, le attività pianificate, la sentinella. Ma le frecce tra loro si erano spezzate senza rumore. Il sintomo non era un guasto visibile, era un silenzio: niente segnalava che niente circolava.
DifficoltàUna decisione attesa da giorni, che nessuno presentava: restava in un rapporto che nulla rileggeva.
SoluzioneOgni domanda in sospeso va in un'unica coda di decisioni, letta dal cruscotto.
DifficoltàPassaggi di routine segnati come «riusciti» che non avevano prodotto nulla.
SoluzioneUn passaggio è riuscito solo se lascia una traccia datata del giorno: registro, file o riga di tabella.
DifficoltàAttività pianificate che non vedevano i plugin installati nella sessione interattiva.
SoluzioneOgni attività dichiara ciò di cui ha bisogno e verifica all'avvio che sia disponibile; altrimenti si ferma e lo dice.
DifficoltàUna sentinella che non vedeva i guasti, perché leggeva gli stessi registri dei mattoni che sorvegliava.
SoluzioneLa sentinella verifica i prodotti (file, pagine, righe), non le dichiarazioni.
!Un sistema silenzioso non è per forza un sistema in salute: anche l'assenza di allerte va verificata.
Concetto
Che cosa sarà lo strumento, e che cosa farà?
Fare quattro rilevazioni
Prima di riparare, rilevare l'esistente in quattro parti: le conversazioni (ciò che è stato chiesto e fatto), le skill e i connettori (ciò che è installato, dove e per quale uso), le attività pianificate e il cruscotto (ciò che gira e ciò che viene mostrato), il sito pubblico (ciò che è pubblicato). Ogni rilevazione è datata e dice ciò che non è riuscita a leggere.
Da dire a Claude«Fai quattro rilevazioni del mio sistema senza modificare nulla: conversazioni degli ultimi due mesi, skill e connettori installati, attività pianificate e cruscotto, sito pubblico. Per ogni elemento: dove vive, cosa legge, cosa scrive e la sua ultima traccia datata. Concludi con ciò che non hai potuto consultare.»
DifficoltàLe stesse skill installate in due posti, in due versioni diverse.
SoluzioneLa rilevazione annota versione e posizione di ogni copia; una sola fonte fa fede, le altre ne derivano.
Disegnare la mappa e passare su tutte le frecce
Una mappa del sistema: ogni mattone è una casella, ogni scambio una freccia (chi scrive cosa, chi lo legge, in quale momento). Poi un passaggio su tutte le frecce, una per una: la fonte scrive davvero? Il destinatario legge nello stesso posto? Una freccia senza lettore, o un lettore senza fonte, è un guasto in attesa.
DifficoltàPercorsi di file scritti per un vecchio computer, ancora usati da alcune attività.
SoluzioneI percorsi sono raccolti in un unico file di configurazione, che ogni mattone rilegge.
!Diverse decine di frecce: non verificarle a memoria, ma una per una, con una prova.
Realizzazione
Che cosa chiedere a Claude, e in quale ordine?
Provare a vuoto ed elencare problema → soluzione
Ogni elemento viene lanciato a vuoto, senza scrivere nulla, per vedere cosa leggerebbe e cosa produrrebbe. Ogni scarto diventa una riga problema → soluzione su una pagina in cui un pulsante copia il prompt di correzione, pronto da incollare in una nuova conversazione.
DifficoltàUna prova a vuoto che scriveva comunque nel registro reale.
SoluzioneUna modalità di prova esplicita, che scrive in una cartella di test e lo annuncia in testa al risultato.
Restituire in quattro blocchi
La restituzione è in quattro blocchi: ciò che Claude corregge senza consenso (un refuso in un file di regole), ciò che richiede il consenso (modificare un'attività, toccare una pagina pubblicata), i percorsi da armonizzare, e ciò che spetta solo alla persona: ricollegare un account, installare un plugin su una postazione, scegliere tra due opzioni. Quest'ultimo blocco si intitola «restate solo voi».
Da dire a Claude«Ecco l'elenco problema → soluzione. Metti ogni riga in uno dei quattro blocchi: senza consenso, con consenso, percorsi, restate solo voi. Per ogni riga del blocco «con consenso», scrivi la domanda da farmi e l'opzione che consigli.»
DifficoltàUn elenco di diverse decine di correzioni, illeggibile in un blocco unico.
SoluzioneIl blocco «restate solo voi» è breve e messo in testa: è l'unica parte che aspetta un'azione umana.
Prova
Come dimostrare che funziona?
Eseguire i consensi, poi rileggere ogni scrittura alla fonte
Una volta dati i consensi, Claude esegue, poi verifica ogni scrittura con un andata e ritorno: rilegge il file, la pagina o la riga dal punto in cui il mattone destinatario la leggerà, e non in base a ciò che crede di aver scritto.
DifficoltàUna correzione annunciata come fatta, ma scritta in una copia che nessuno leggeva.
SoluzioneNessuna correzione è dichiarata fatta senza rilettura dalla fonte reale, con la prova (data, estratto).
!Una correzione non riletta è un'ipotesi, non un fatto.
Aggiungere due controlli nati dalla diagnosi
Due nuovi controlli entrano nella sorveglianza: «attività riuscita ma senza registro del giorno», che scova i passaggi vuoti, e «il percorso utente corrisponde alla postazione attuale», che scova i percorsi ereditati da un vecchio computer.
Messa in servizio
Come consegnarlo, pubblicarlo e farlo durare?
Un monitor a spie
Un monitor raggruppa le spie per area (posta, agenda, cruscotto, attività, sito, connettori). Prova i connettori in diretta, mostra allarmi che si possono prendere in carico con il loro storico, e una mappa del sistema in cui la freccia guasta lampeggia.
DifficoltàAllarmi rimasti rossi dopo la correzione, che finivano ignorati.
SoluzioneOgni allarme si prende in carico a mano, con data e motivo; un allarme preso in carico che ritorna risale in cima.
Un audit domenicale, un giudice separato, una pagina di decisioni
Ogni domenica un audit rilegge il sistema con l'età di ogni allerta e la dormienza dei progetti. Il giudice è separato da ciò che giudica: la sentinella constata, non ripara mai. Le domande che solleva finiscono su una pagina di decisioni di sistema, una scheda per domanda con un'opzione consigliata, e nulla cambia prima della risposta.
DifficoltàUna sentinella che correggeva da sola ciò che trovava, nascondendo così i guasti ricorrenti.
SoluzioneConstatare e riparare sono due ruoli distinti; la riparazione passa per la decisione, poi per una rilettura.
!Il dettaglio dell'audit settimanale e della pagina di decisioni si trova nella scheda sull'inventario incrociato.