Costruire un manuale d’uso con l’AI — Case Study Gestionale Zucchetti
Come trasformare un software senza documentazione in un manuale strutturato, con l’aiuto di Claude
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.
Apri il Manuale Gestionale Zucchetti →