Idea principale

Un'API che restituisce duecento elementi e un'API che ne restituisce trentamila richiedono due progettazioni diverse: la prima si carica e si mostra, la seconda impone paginazione, filtri lato server e una strategia di caricamento. Niente nel codice distingue i due casi, e niente nemmeno in un set di dati di sviluppo.

Un assistente come Claude Code che non ha ricevuto alcuna informazione sui volumi reali produce quindi la soluzione più diretta: caricare tutto, passare tutto alla pagina, filtrare tutto lato front. In sviluppo, con qualche decina di righe, funziona — ed è proprio questo il problema, perché la verifica passa.

Il guasto che segue non ha l'aspetto di un guasto. Non c'è nessun errore rosso in console: c'è una pagina che ci mette otto secondi a rispondere, un browser che si blocca, un comportamento che si attribuisce alla rete. Un difetto silenzioso non è solo più difficile da correggere, è più difficile da ricondurre alla sua causa — e chi non ha cultura tecnica non lo riconosce nemmeno come difetto.

Perché è importante

Individua una categoria di informazioni che l'assistente non può dedurre e che bisogna fornirgli: gli ordini di grandezza della realtà. Né la lettura del codice esistente, né il set di test, né la formulazione della richiesta li contengono.

Dice anche cosa un set di dati di sviluppo non dimostra mai. Un collaudo superato su dati di test attesta che il comportamento è corretto, non che regge — e sono due proprietà che si convalidano nello stesso momento, sulla stessa schermata, senza che nulla le separi.

Sfumature e limiti

Il meccanismo non è proprio degli assistenti: gli sviluppatori hanno sempre consegnato query che crollano in produzione. Quello che cambia è la frequenza, dato che nessuno si pone la domanda quando il codice compare in pochi secondi.

E dichiarare i volumi non sempre basta: certi vincoli si scoprono solo in produzione, su distribuzioni di dati che nessuna stima aveva previsto.

Domande aperte

• Quali altri vincoli della realtà sono, come i volumi, invisibili nel codice e assenti dal set di test — la latenza delle dipendenze, gli accessi concorrenti, la dimensione degli allegati?