Costruire un manuale d'uso con _l'AI_ — Case Study Gestionale _Zucchetti_

Sun, 01 Jun 2025 00:00:00 +0000

Il problema

Gestionale 1 Zucchetti è un software di contabilità e amministrazione diffuso nelle scuole italiane. Robusto, ricco di funzioni — e, nella versione in uso nel nostro istituto, privo di un manuale d’uso aggiornato e accessibile.

La situazione concreta: dover formare personale nuovo su procedure operative complesse — registrazione presenze, gestione supplenze, rendicontazione — senza avere documentazione di riferimento. Il manuale ufficiale Zucchetti esiste, ma è voluminoso, generico, non calibrato sulle procedure specifiche dell’istituto.

L’approccio

Invece di produrre documentazione “a mano” — procedura lenta, soggetta a errori e difficile da mantenere aggiornata — ho usato Claude come co-autore strutturale.

Il flusso di lavoro:

Osservazione operativa — ho registrato le procedure reali, voce per voce, seguendo il personale durante le operazioni quotidiane.
Strutturazione con l’AI — ho descritto a Claude le procedure osservate in linguaggio naturale; Claude ha proposto una struttura modulare (capitoli, sezioni, note operative, avvisi).
Raffinamento iterativo — ogni sezione è passata attraverso cicli di revisione: io correggevo i dettagli tecnici specifici dell’istituto, Claude affinava la chiarezza espositiva e la coerenza del registro.
Output finale — un documento HTML interattivo con sommario laterale, ricerca, modalità chiara/scura, ottimizzato per la lettura su schermo.

Cosa ha funzionato

Velocità di scaffolding: la struttura del manuale — che avrei impiegato giorni a progettare — è emersa in poche ore.
Coerenza del registro: Claude mantiene il tono uniforme tra sezioni scritte in momenti diversi, cosa difficile da garantire in un documento collaborativo.
Note operative e avvisi: chiedendo esplicitamente di identificare i passaggi critici (“dove può andare storto qualcosa?”), il modello ha suggerito punti di attenzione che non avrei documentato spontaneamente.

I limiti

Accuratezza tecnica: l’AI non conosce il software. Ogni dato specifico — percorso di menu, nome esatto di un campo, comportamento di un pulsante — deve venire dall’osservazione diretta e non può essere delegato.
Aggiornamento: quando il software cambia, il manuale va aggiornato. L’AI accelera la riscrittura, ma non la sostituisce.
Verifica obbligatoria: tutto ciò che l’AI produce va validato da chi conosce le procedure reali. Il documento finale è mio — l’AI è uno strumento, non un autore autonomo.

Conclusione

Questo case study è un esempio concreto di quello che definisco uso efficiente dell’AI: non delegare il ragionamento, ma usare il modello per le parti del lavoro in cui è oggettivamente più veloce e preciso di un essere umano — struttura, coerenza, linguaggio — restando responsabili delle parti che richiedono conoscenza situata: procedure reali, contesto istituzionale, verifica.

Il manuale prodotto è accessibile al link qui sotto, protetto da password per uso interno.