Tutti gli articoli Costruire in pubblico

Il giorno in cui l'audit mi ha ignorato

Un diario di sviluppo su un piccolo bug di instradamento con una grande lezione: una richiesta che nomina già il lavoro non dovrebbe dover sopravvivere a un passaggio di indovinello.

Moose
Moose
14 lug 2026 · 4 min di lettura
Una pallina da tennis intatta sul pavimento accanto a una scrivania, in uno studio di casa in penombra illuminato da una lampada

Il bug era educato, e questo lo peggiorava

Faceva clic sul prompt audit AEO nella schermata iniziale. Vedeva atterrare le parole "audit aeo" nella casella della chat. E poi l'app ci pensava un momento e le raccontava, con calore, che cos'è un audit AEO.

Non ne eseguiva uno. Ne spiegava uno. Come chiedere a un cane di riportare la pallina e ricevere una breve conferenza sulla storia delle palline.

Ecco cosa succedeva sotto il cofano. Prima che un messaggio diventi lavoro, un modello piccolo lo legge e decide se vuole che qualcosa venga costruito o che una domanda riceva risposta. È un compito ragionevole. Le istruzioni che gli avevamo dato, però, erano soprattutto un lungo elenco di avvertimenti sul non saltare alle conclusioni. Non eseguire un audit solo perché qualcuno ha detto la parola audit. Non dare nulla per scontato. Non esagerare. Abbiamo scritto un piccolo ansioso molto scrupoloso, poi gli abbiamo passato due parole senza nemmeno un verbo, e ha fatto quello che fanno gli ansiosi. Ha deciso che probabilmente lei era solo curioso.

Due correzioni, e solo una è quella interessante

La correzione noiosa è stata riscrivere quelle istruzioni in modo diretto. Se qualcuno comanda il lavoro, anche in due parole stanche, esegui il lavoro. Se qualcuno chiede che cosa sia il lavoro, parlagli. Più corto, più chiaro, meno avvertimenti. Ha aiutato.

La correzione che conta è che i prompt predefiniti non chiedono più il permesso. Quando fa clic sul pulsante dell'audit AEO, l'app apre l'audit direttamente. Non c'è più un classificatore in mezzo, perché non c'è nulla da classificare. Ha fatto clic sul pulsante che dice audit. L'intenzione non è ambigua, e un passaggio che può solo fallire non è un passaggio da tenere.

È la lezione che continuo a imparare da queste parti. Ogni supposizione che lascia lungo il percorso è un punto in cui il prodotto può fraintendere qualcuno che era già stato chiaro.

Già che c'eravamo, una domanda più scomoda

Una volta che l'audit girava in modo affidabile, è diventato più facile capire se l'audit fosse buono.

Non lo era del tutto. Le soglie del punteggio erano impostate in modo che alcune pagine ricevessero lo stesso consiglio generico a prescindere dal loro contenuto, e le categorie deboli ricevevano gesti simbolici. Una pagina con 48 su 100 sui segnali di affidabilità si vedeva proporre un unico suggerimento: aggiungere un'indicazione di fonte a una riga. Quel numero è un'insufficienza, e la soluzione era un'alzata di spalle.

Perciò ora la profondità delle raccomandazioni cresce con la dimensione del problema. Se una categoria è davvero insufficiente, riceve modifiche sostanziali proporzionate al deficit, come riscrivere le sue affermazioni fattuali più forti con fonti citate e verificabili. E una categoria che l'app le mostra in rosso non può più tornare senza nulla da fare.

Abbiamo anche fatto in modo che la freschezza significhi una cosa sola. La freschezza è quando la pagina è stata aggiornata l'ultima volta. Non è un cassetto in cui infilare qualsiasi modifica che migliori la scrittura. Se il suo unico scarto di freschezza è una data che invecchia, le si deve dire quale aggiornamento di contenuto giustificherebbe onestamente un rinfresco, non passarle una riscrittura travestita da freschezza.

E abbiamo cancellato il consiglio di accorciare i titoli. La lunghezza del titolo non è un fattore rilevante per i motori di risposta. I motori di risposta leggono il corpo del testo. Distribuivamo consigli ordinati, sicuri di sé e inutili, e l'inutilità ordinata e sicura di sé è la specie peggiore.

Corretto anche questo, con meno drammi

Passare a un piano a pagamento faceva sparire dal gestore dei prompt quelli che aveva scritto in locale. Non venivano cancellati, ma non venivano mostrati, il che dal suo posto è la stessa cosa. Ora vengono copiati al momento dell'upgrade, abbinati per testo così nulla arriva due volte.

Connessioni ha ricevuto un giro di irrobustimento della sicurezza, la tabella della libreria ha un layout più pulito, e una scheda Connessioni che prometteva cose che non abbiamo ancora costruito resta nascosta finché non le costruiremo.

Cosa ho notato

Ogni bug di questa settimana era lo stesso bug con un cappello diverso. L'app sapeva che cosa voleva lei, e poi aggiungeva un passaggio in cui poteva convincersi di non saperlo.

Vado a sdraiarmi sotto la scrivania a pensarci.

Moose
Moose
Hi, Moose

Quello che sta sotto la scrivania per tutto il tempo.