YAML: una piccola struttura che cambia il modo di lavorare

Fino a qui abbiamo parlato di problemi: la romanella, le tre forme di colpa, le informazioni che mancano o si perdono.

Fino a qui abbiamo parlato di problemi: la romanella, le tre forme di colpa, le informazioni che mancano o si perdono. Ora parliamo di uno strumento — semplice, leggibile, già usato in milioni di sistemi informatici nel mondo — che affronta questi problemi alla radice.

Si chiama YAML. E non è necessario essere informatici per capire cosa fa.

Cos’è YAML, in parole semplici

YAML è un modo di scrivere informazioni in forma strutturata, leggibile sia dalle macchine che dagli esseri umani. Non è un programma, non è un’applicazione: è una convenzione di scrittura, come il modo in cui si compila un modulo o si intestata una lettera ufficiale.

Immagina di dover descrivere un report in modo che chiunque — collega, sistema informatico, intelligenza artificiale — possa capire immediatamente di cosa si tratta, chi lo ha scritto, quando, su cosa. In italiano corrente potresti scrivere:

Questo report si intitola “Credito alle imprese”, riguarda la Basilicata, è stato prodotto da un ufficio studi nel 2026 usando dati Banca d’Italia.

Tutte le informazioni ci sono. Ma sono sepolte in una frase. Estrarle richiede lettura, interpretazione, attenzione.

In YAML la stessa informazione si scrive così:

• report_metadata:

• title: “Credito alle imprese”

• territory: “Basilicata”

• year: 2026

• source: “Banca d’Italia”

• author: “Paolo Volterra”

Ogni voce ha il suo campo. Ogni campo ha il suo nome. Non serve interpretare nulla: la struttura parla da sola.

Ciò che YAML fa davvero: rendere esplicito l’implicito

Il valore di YAML non è tecnico — è cognitivo e organizzativo.

Quando si compila un blocco YAML prima di scrivere un documento, si è costretti a rispondere a domande precise: chi sono? cosa sto producendo? per quale periodo? con quali dati? Domande che nel flusso normale del lavoro vengono spesso saltate — non per malafede, ma perché nessuno le ha mai rese obbligatorie.

YAML trasforma quelle domande in campi da riempire. Esattamente come le colonne del foglio di gioco. Se il campo source è vuoto, si vede subito. Se year manca, è evidente. La struttura rende visibile l’assenza — cosa che un testo in prosa non fa mai.

YAML e la romanella

Torniamo agli esempi del capitolo 2.

Il report senza fonte? Con YAML il campo source sarebbe stato obbligatorio fin dall’inizio — o almeno visibilmente vuoto, segnale immediato di un’informazione mancante.

Il documento senza versione? Un campo version: “1.0 — bozza” risolve il problema in una riga. L’analisi senza dataset? dataset: “MIR Banca d’Italia, serie mensile 2020-2025” — scritto una volta, disponibile sempre.

La presentazione fatta in fretta? Anche una presentazione può avere un’intestazione strutturata: tre righe di YAML che dicono a chiunque la riceva di cosa si tratta, chi l’ha prodotta e a quale riunione si riferisce.

La romanella prospera nell’implicito. YAML vive nell’esplicito. I due non convivono facilmente.

Si è verificato un errore.

Impossibile eseguire JavaScript

Una piccola struttura con effetti grandi

YAML non richiede software speciale, non richiede formazione tecnica avanzata, non richiede di cambiare i propri strumenti di lavoro. Richiede solo una cosa: l’abitudine di dichiarare le informazioni prima di produrre contenuto.

È un cambio di prospettiva più che un cambio di strumento. Prima di scrivere, si dichiara. Prima di analizzare, si descrive il contesto. Prima di condividere, si verifica che i campi essenziali siano compilati.

Questo principio — dichiarare prima, produrre dopo — non è solo una buona pratica informatica. È lo stesso principio alla base delle checklist in medicina, dei protocolli in aviazione, dei moduli standardizzati in finanza. Strutture semplici che, in ambienti ad alta complessità, riducono gli errori in modo sistematico.

Nel capitolo 6 vedremo come YAML si colleghi direttamente a queste pratiche. Prima, però, è utile capire come l’intelligenza artificiale cambia il valore di avere informazioni ben strutturate — e perché un documento con metadati YAML vale molto di più, per una macchina, di uno scritto in prosa libera.

---

Pubblicato in origine su Substack il 12 marzo 2026.

Vedi anche

• La romanella: quando il lavoro perde strutturaC’è una parola italiana che non ha equivalenti precisi in altre lingue: romanella.
• La colpa organizzativa: negligenza, imprudenza e imperiziaLa romanella è scomoda.
• ChatGPT & Reverse EngineeringRicavare i valori di un grafico da un’immagine con un LLM: come far lavorare in gruppo modello, OCR e Python.