Creare un'osservazione

1. Nell'editor#

La via ordinaria, e quella da usare a meno di avere un motivo per non farlo. Disegna ciò che è stato visto, di' quando e dove, registra come si è mosso — e il cielo, il meteo e il terreno vengono ricavati per te invece che ricordati.

Apri l'editor Leggi il manuale

Si conclude con Salva, che ti consegna un file. Quel file è l'intera registrazione: non c'è alcun account e qui non si conserva nulla. Mettilo da qualche parte con un indirizzo pubblico ed è pronto da condividere.

Ne hai già una e vuoi modificarla? L'editor si apre su una registrazione esistente — il pannello ? di ogni ricostruzione pubblicata contiene il link che lo fa.

2. Con un assistente IA, a partire dal fascicolo#

Quando un caso ha già i suoi documenti (un rapporto, un questionario, una dichiarazione, schizzi, foto del luogo, una mappa), la via più rapida è spesso affidarli a un assistente IA in grado di leggere PDF e immagini e di eseguire un po' di codice, indicargli questa documentazione e fargli scrivere il file. Legge il resoconto, misura i disegni, calcola le direzioni dalla mappa, ricava ciò che si può ricavare e scrive ciò che ha trovato nel formato. Poi tu guardi il risultato, e gli dici che cosa non va.

L'assistente non sa del caso se non ciò che gli dai, né del formato se non ciò che dicono queste pagine. Chiedigli quindi la disciplina che manterrebbe un investigatore:

Ecco i documenti di un caso di avvistamento. Costruisci una
registrazione UFO@home di ciò che l'osservatore ha visto: il file JSON
descritto su https://ufoathome.org/docs/format/ , verificato con
https://ufoathome.org/sighting.schema.json .

- Indica solo ciò che i documenti sostengono. Scrivi ogni valore che hai
  calcolato come {"value": ..., "basis": "derived", "rationale": "..."}
  e ogni valore che hai dovuto scegliere con "basis": "assumed".
- Il fenomeno è fatto solo di angoli: la sua direzione (aim) e la sua
  dimensione apparente (angular) in ogni istante. I metri indicati
  dall'osservatore vanno in "interpretation", mai nelle forme.
- Una registrazione per osservatore. Quando ce ne sono più d'uno, scrivi
  anche il file del caso che li elenca (vedi «Più osservatori: il
  caso»).
- Prendi persone, veicoli, alberi ed edifici dal catalogo
  https://ufoathome.org/models/index.json , per id: non inventare mai
  un modello.
- Di' in "summary", in una o due frasi, di che cosa tratta il caso.
- Elenca le contraddizioni tra i documenti, e le domande da riproporre
  all'osservatore o all'investigatore.

Altre due cose da dirgli. Ciò che il lettore calcola da sé a partire dalla data e dal luogo (il cielo, i pianeti, la Luna e le eclissi, i satelliti, il rilievo e le immagini) non si scrive nel file: la pagina Fonti e scelte elenca ciò che è letto e da dove, e il file deve portare solo ciò che dicono i documenti. E i modelli si scelgono dal catalogo per id, che dice anche quali impostazioni offre ciascuno (modelParameters): una persona non è mai disegnata come forma integrata.

Oppure installa la skill di UFO@home nel tuo assistente: le stesse istruzioni, con il metodo, le regole del formato, lo schema, un esempio e un validatore che richiede solo Python, così che non resti che affidargli i documenti. Scarica la skill (uno zip da aggiungere alle skill di Claude, o da decomprimere in ~/.claude/skills/ per Claude Code), oppure leggila prima.

Poi controlla ciò che ha scritto, come controlleresti il lavoro di un collega:

• Riproducila. Aprila nel lettore, dal tuo computer con le foto che nomina. Il fenomeno è dove lo mettono i disegni, davanti agli alberi giusti, alla giusta altezza sopra l'orizzonte? Di' che cosa non torna, e fallo correggere.
• Leggi i valori assumed. Sono l'elenco di ciò che nessuno ha detto. Ognuno è una domanda per l'osservatore, o un punto in cui la ricostruzione poggia su un'ipotesi.
• Completa nell'editor ciò che è più facile fare con il mouse che con una frase: spostare un edificio di qualche metro, ritoccare una direzione finché non cade sulla foto.
• Mostrala all'osservatore. L'unica prova che conta è se riconosce ciò che ha visto.

Un osservatore che ha solo il proprio resoconto può farlo dentro l'editor: lo scrive nella scheda Riepilogo, sceglie che cosa lo redige (oggi Claude: la propria chiave API, e il modello), e l'editor redige il resto della registrazione a partire da esso, senza inviare nulla da nessuna parte se non a quel modello.

Un resoconto è un dato personale. Prima di affidare documenti a un assistente online, togli ciò che identifica l'osservatore a meno che non abbia acconsentito, e verifica che cosa conserva il servizio. E un assistente può sbagliare con sicurezza: il file vale quanto i documenti su cui si basa e la verifica che lo segue.

3. A mano, o dal tuo archivio#

Una registrazione è un file dalla forma documentata, quindi nulla ti impedisce di scriverne una in un editor di testo, o di generarne mille da un database che hai già: è esattamente ciò che scrive l'editor stesso.

Tutto ciò che l'editor scrive, campo per campo, con un file completo da digitare e le demo che vale la pena leggere, è nella sua pagina: il file di avvistamento.

Leggi il formato

Fonti e scelte#

Nulla di ciò che lo strumento disegna è inventato. Ogni valore viene da una fonte nominata, letta in un momento dichiarato, e dove non esiste alcun dato l'interfaccia lo dice invece di colmare il vuoto.

Redazione e valutazione

Redazione e valutazione

Il dettaglio di ogni scelta, con le misure che l'hanno decisa, è nei commenti al codice di ogni fonte nel repository.