TESTO REALE, RIPULITO SOLO PER LA PRIVACY. Questi sono davvero i primi messaggi scritti a Claude Code per far nascere il Portale Viaggi e il Portale FSL della nostra scuola. Sono lasciati quasi alla lettera, refusi compresi: è istruttivo vedere che non serve scrivere un prompt perfetto per iniziare bene. Sono stati tolti solo i percorsi sul computer di Thomas, il link a un foglio Google privato e il nome di una classe: al loro posto trovate una descrizione tra parentesi quadre.

Come sono nati i portali: i primi prompt

Un glossarietto, prima di leggere

Nei prompt compaiono alcuni nomi tecnici. Per il corso non serve saperli usare: basta sapere dove "girano" le cose e con che tecnologia sono scritte.

Termine	Cosa vuol dire, in parole semplici
Contabo	Il fornitore del server personale del docente, usato per le prime prove dei portali. Poi i portali sono stati spostati nella rete della scuola, in una zona separata dal resto della rete (la DMZ, pensata per i servizi che devono essere raggiungibili da fuori).
KB (base di conoscenza)	Una raccolta di note e istruzioni scritte in precedenza, che l'IA può consultare invece di dover ripartire da zero ogni volta.
Node.js	La tecnologia con cui è scritto il "motore" del portale, la parte che elabora i dati dietro le quinte.
Postgres (PostgreSQL)	Il programma che conserva in modo ordinato tutti i dati del portale: pratiche, firme, utenti.
Docker	Uno strumento che "impacchetta" il portale in un contenitore standard, così può girare allo stesso modo su computer diversi: prima il server di prova, poi quello della scuola.
React + Vite + Tailwind	Le tecnologie con cui è scritta la parte del portale che si vede e si usa a schermo: le pagine, i moduli, i pulsanti. Vite, in particolare, è lo strumento che prepara le pagine.
/goal	Un comando che dà a Claude Code un obiettivo dichiarato all'inizio, che l'agente tiene come traguardo e persegue in autonomia finché non è raggiunto (o finché la persona non lo interrompe). Funziona meglio con un traguardo preciso e verificabile ("i test passano"), non vago ("sistema il codice"). È lo stesso ciclo dell'agente visto nell'incontro 1: un obiettivo vago porta fuori strada, e chi controlla il risultato resta sempre una persona.

Prompt del Portale Viaggi (5 luglio 2026)

Allegati forniti insieme a questo messaggio: il regolamento viaggi della scuola e due moduli di uscita compilati come esempio.

voglio informatizzare e automatizzare completamente il sistema di gestione delle pratiche viaggi e uscite didattiche della mia scuola.

il portale sviluppato con tecnologia nodejs con frontend a tutta discrezione (in base alle info nella nostra KB) con database posgres dovrà essere conteneirizzato su docker e posizionato sul portale della scuola. nel frattempo per tutta la fase di test possiamo utilizzare il nostro server su contabo nel quale abbiamo gli altri progetti.

per capire il funzionamento del sistema ti metto a disposizione il regolamento scolastico e i moduli per le uscite (in allegato due di esempio compilati).

facciamo una ragionata insieme su come rimuovere completamente tutto il cartaceo, quindi consentire a studenti, genitori e docenti di firmare e prendere visione dei moduli di autorizzazione tramite il riconoscimento digitale (suggeriscimi come).

il portale dovrà servire oltre a docenti che organizzano le uscite, alla commissione viaggi che le dovrà approvare, alla segreteria scolastica che dovrà seguire l'iter del viaggio e gestire eventuali preventivi e richieste di preventivo.

per autenticare gli utenti scolastici possiamo utilizzare autenticazione Google sul dominio ittsrimini.edu.it.

la dirigenza potrà vedere tutte le pratiche e porre un visto per ok, una richiesta di revisione con motivazione o un diniego.

analizza tutti i documenti ed estrapola tutte le info necessarie per la produzione dettagliata del sistema. sfrutta tutta la potenza agentica per svolgere il lavoro in modo parallelo e attento.

per questo progetto crea un repo github provato sul mio git (trovi tutte ne info in kb)

in base alla tua esperienza suggeriscimi anche l'implementazione di funzionalità che non ti ho elencato ma che possono esse utili per il nostro scopo.

Prompt del Portale FSL (luglio 2026)

/goal voglio informatizzare e automatizzare completamente il sistema di gestione dei percorsi di Formazione Scuola Lavoro (FSL e per molti ex PCTO)

il portale sviluppato con tecnologia nodejs con frontend react+vite+tailwind con database posgres dovrà essere conteneirizzato su docker e posizionato sul portale della scuola.

esattamente come il portale che abbiamo già realizzato per la commissione viaggi (progetto commissione-viaggi-itts) da cui puoi prendere abbondantemente spunto

nel frattempo per tutta la fase di test possiamo utilizzare il nostro server su contabo nel quale abbiamo gli altri progetti.

per capire il funzionamento attuale di tutta la gestione FSL ho creato [cartella con i documenti e i modelli] nella quale ho messo tutta la documentazione e i modelli.

per gestire la mia classe in FSL quest'anno ho utilizzato questo specchietto in google fogli che non è esaustivo ma mi ha aiutato molto: [un foglio di calcolo che usavo per seguire la classe]

invece tutta la documentazione che ho prodotto per la classe di cui ero tutor la puoi trovare in [cartella con la documentazione della mia classe di tutor]

suggerisco, dato che abbiamo a disposizione il google workspace istituzionale di strutturare tutto con google doc e google fogli.

per farlo posso fare l'importazione dei documenti in una cartella del drive condiviso "Template" e poi sfruttare quelli per la compilazione dei documenti

facciamo una ragionata insieme su come rimuovere completamente tutto il cartaceo, quindi consentire al responsabile scolastico della FSL, al docente Tutor FSL, dirigente scolastico, agli studenti, ai genitori, ai tutor esterni e alle aziende di svolgere tutte le procedure in modo automatico e direttamente sul portale eliminando o riducendo drasticamente l'utilizzo della carta.

Sfruttiamo tutte le nostre conoscenze e competenze tecniche per studiare soluzioni che consentano di realizzare un sistema all'avanguardia per la gestione della FSL sotto tutti i punti di vista.

per autenticare gli utenti scolastici possiamo utilizzare autenticazione Google sul dominio ittsrimini.edu.it come abbiamo già fatto per i progetti prenota-carrello e soprattutto commissione-viaggi-itts

la dirigenza, così come il responsabile FSL della scuola e il personale della segreteria potrà vedere tutte le pratiche, i docenti tutor interni potranno vedere tutte le pratiche degli studenti assegnati mentre le persone esterne potranno vedere solo le pratiche che sono a loro assegnate (firma della convenzione, report di valutazione, etc etc)

analizza tutti i documenti ed estrapola tutte le info necessarie per la produzione dettagliata del sistema. sfrutta tutta la potenza agentica per svolgere il lavoro in modo parallelo e attento.

per questo progetto crea un repo github provato sul mio git (trovi tutte ne info in kb)

in base alla tua esperienza e alla lettura della documentazione iniziale, suggeriscimi anche l'implementazione di funzionalità che non ti ho elencato ma che possono esse utili per il nostro scopo.

Guida all'osservazione: cosa c'è in un buon prompt iniziale

Rileggendo i due messaggi, si possono riconoscere alcuni ingredienti che tornano in entrambi:

Un obiettivo chiaro, detto nella prima riga: cosa si vuole ottenere, non come.
Il contesto e i documenti come fonte: il regolamento e i moduli compilati per i Viaggi, una cartella di documenti e uno specchietto già in uso per l'FSL. L'IA parte da materiale vero della scuola, non da un'idea generica.
Chi userà il servizio, con quali ruoli e permessi: docenti, commissione viaggi, segreteria, dirigenza per i Viaggi; responsabile FSL, tutor interni, dirigenza, studenti, genitori, tutor esterni e aziende per l'FSL, ciascuno con cosa può vedere.
Come si entra: l'autenticazione Google sul dominio della scuola, indicata esplicitamente in entrambi i casi.
Il problema della carta e della firma: l'obiettivo dichiarato di togliere il cartaceo, con una richiesta esplicita di indicazioni per firmare digitalmente (il "suggeriscimi come" dei Viaggi).
Vincoli tecnici, quando ci sono: le tecnologie, il contenitore Docker, dove far girare le prove prima del server della scuola.
Il modo di lavorare richiesto: "facciamo una ragionata insieme", "analizza tutti i documenti", "sfrutta tutta la potenza agentica... in modo parallelo e attento". Non è solo una lista di richieste: è un invito a ragionare insieme prima di scrivere codice.
La richiesta di suggerire funzioni non elencate: entrambi i prompt chiudono chiedendo all'IA di proporre, in base alla propria esperienza, funzionalità utili a cui Thomas non aveva pensato.

Cosa NON c'è, ed è altrettanto importante notarlo: nessun dettaglio su come sarà fatta ogni singola schermata, quali pulsanti ci saranno, come sarà il menu. Quel livello di dettaglio non nasce dal prompt iniziale: viene costruito dopo, nella conversazione successiva, con i requisiti scritti, le revisioni e il collaudo (lo stesso percorso carta → requisiti → servizio → controlli visto oggi).

La differenza tra i due prompt

Il prompt del Portale FSL non riparte da zero: dice esplicitamente "esattamente come il portale che abbiamo già realizzato per la commissione viaggi... da cui puoi prendere abbondantemente spunto". Il secondo progetto riusa l'esperienza del primo (le stesse tecnologie, la stessa autenticazione Google, lo stesso modo di firmare digitalmente): si impara di progetto in progetto, non si riparte sempre daccapo.

Domande per l'attività

Confrontate il vostro elenco di requisiti dell'attività precedente ("Dalla carta ai requisiti") con questi due prompt: cosa c'è qui che nel vostro elenco mancava?
C'è qualcosa in questi prompt che, guardandolo ora, cambiereste o scrivereste in modo diverso?