Racconto di due domande su Claude Code

Due domande sullo stesso strumento hanno incrociato la mia strada di recente su Stack Overflow, e non potevano incontrare fini più diverse. "How do you index a codebase in Claude Code?" (come si indicizza una codebase in Claude Code?) stava a meno otto, chiusa, giù in basso, in compagnia di compiti a casa scaricati lì di peso e di una richiesta di aiuto per craccare una password. Nel frattempo, una risposta a "Is reviewing only by sight a good use of Claude Code to write code?" (rivedere solo a occhio è un buon uso di Claude Code per scrivere codice?) segnava 13 punti, il che sullo Stack Overflow di oggi è aria rarefatta, la lega di una bellissima spiegazione dell'aritmetica dei CRC e di una pila di burocratese dello standard C++.

Stesso strumento. Stesso sito. Stessa comunità a votare. Verdetti opposti. Ho letto entrambe le domande più volte di quanto meritino, perché credo che il divario tra le due non sia rumore, e non sia nemmeno ostilità verso l'AI. La comunità sta smistando, e una volta che vedi la regola dello smistamento, puoi usarla.

Quella che è morta

Cominciamo dal cadavere. "How do you index a codebase in Claude Code?" è una frase che suona ragionevole. È anche, e lo dico con simpatia, tre errori distinti sotto un unico punto interrogativo.

Primo, poggia su una premessa che lo strumento non ha. Claude Code non costruisce un indice della tua codebase. Cerca su richiesta, come faresti tu con grep, e l'intero design scommette che la ricerca veloce batta un indice stantio. Chiedere come si configura l'indice è chiedere come si sella un'automobile. Non c'è risposta alla domanda così com'è posta, solo una correzione della domanda, e le domande a cui si può rispondere solo smontandone la premessa se la passano male ovunque, non solo su Stack Overflow.

Secondo, è una domanda di supporto. Non una domanda minore, ma un genere diverso: la sua vera risposta vive nella documentazione del fornitore e cambia con le sue note di rilascio. Stack Overflow chiude le domande di supporto sugli strumenti da molto prima che questo strumento esistesse, perché il formato del sito presuppone una risposta che valga la pena archiviare per un decennio, e le risposte di supporto marciscono in un trimestre. Quando la durata di conservazione di una domanda è più corta della sua coda di revisione, chiuderla non è gatekeeping. È gestione di magazzino.

Terzo, ed è l'errore che mi sta davvero a cuore, chiede dello strumento e non del lavoro. Che è esattamente la trappola di cui ho scritto nell'articolo sull'inseguire gli strumenti: lo strumento è la parte che puoi sostituire in un giorno, e la parte sotto, quella che ha richiesto anni, è dove vivono le domande durevoli.

Quella che è sopravvissuta

Ora la sopravvissuta. "Is reviewing only by sight a good use of Claude Code to write code?" non ha premesse da smontare, perché non afferma nulla su come funziona lo strumento. Non ha problemi di scadenza, perché sarà ancora una domanda viva fra tre strumenti e cinque versioni; sostituisci il nome del prodotto ed era una domanda viva nell'era dell'outsourcing, e della code review in generale. E non è una domanda di supporto, perché nessuna documentazione di fornitore può risolverla. È una domanda di giudizio. L'unica risposta onesta è l'esperienza: qualcuno che ha rivisto a occhio, ha rilasciato il risultato e ha scoperto quanto costa.

La risposta che ha segnato 13 punti vale qualcosa proprio perché non può essere generata su richiesta. Un modello produrrà volentieri un saggio sulle pratiche di review, e sarà fluente e generico. Quello che i votanti hanno premiato era diverso: una persona che prende posizione a partire dalle proprie cicatrici, su una domanda in cui le posizioni sono tutto ciò che c'è.

Divulgazione completa: questa ha trovato un bersaglio morbido anche in me. Ho pubblicato un articolo esattamente su questa domanda circa una settimana prima che i votanti del sito sollevassero quella risposta in quell'aria rarefatta, sostenendo che leggere un diff è review vera per un tipo di modifica e una storia consolante per un altro. Non so chi abbia posto la domanda né chi abbia risposto, e non sto sostenendo che l'articolo abbia causato alcunché. Quello che sostengo è più piccolo e più interessante: la domanda è nell'aria. Quando lo stesso tema affiora in modo indipendente su un blog personale e su Stack Overflow nel giro delle stesse poche settimane, ecco che aspetto ha una domanda viva vista da due punti di osservazione.

La regola dello smistamento

Metti le due domande una accanto all'altra e la regola quasi si enuncia da sola.

Chiediti se il prossimo rilascio potrebbe rendere la tua domanda priva di senso. Se il fornitore rilascia una funzionalità domani, o ne rinomina una, e la tua domanda evapora, è una domanda di supporto, e la folla di sconosciuti di un sito di domande e risposte è il pubblico sbagliato per lei. Il pubblico giusto sono i documenti, il changelog, i canali del fornitore stesso, o dieci minuti con lo strumento in persona, che dimostrerà il suo comportamento reale più in fretta di quanto un forum possa descriverlo. Niente di vergognoso nella categoria. È solo deperibile, e gli archivi sono per ciò che dura.

Ma se la tua domanda sopravvivesse alla scomparsa dello strumento, se potessi cancellare il nome del prodotto, scriverci al posto quello di un concorrente e avere ancora bisogno della risposta, allora non stai affatto chiedendo dello strumento. Stai chiedendo del lavoro: cosa delegare, cosa verificare, quanto costa una pratica, dove il giudizio deve restare umano. Quelle domande non hanno data di scadenza, non hanno documentazione a cui essere rimandate e non hanno premesse da far crollare. Sono anche, non per coincidenza, le domande a cui l'AI risponde peggio, perché la risposta non è retrieval. È testimonianza.

Il voto della comunità è stato duro da un lato di quella linea e generoso dall'altro, e credo che la durezza e la generosità siano lo stesso segnale letto due volte. Un sito che archivia risposte per decenni ha tutte le ragioni per respingere ciò che marcisce e accumulare ciò che si conserva. L'AI non ha creato quella logica. Ha solo spostato la linea, facendo marcire più in fretta tutto ciò che è recuperabile.

Chiedere alla luce del sole

Se c'è un consiglio in tutto questo, non è «evita di fare domande sugli strumenti di AI in pubblico». È: prima di chiedere, scopri quale delle due domande hai in mano. La domanda di supporto merita dieci minuti con la documentazione, e onestamente, il modello stesso le risponderà meglio di un forum, dato che descrivere il proprio comportamento è l'unico tema su cui è la fonte primaria. La domanda di giudizio merita il trattamento opposto. Portala alle persone, e vestila a dovere: dai un nome alla posta in gioco, racconta cosa hai provato, esponi la tua posizione provvisoria perché la testimonianza abbia qualcosa contro cui spingere.

Le due domande le hanno poste due sconosciuti che non sapranno mai di essere stati una coppia perfetta. Fra tutte e due hanno mappato l'intero territorio: cosa non portare agli altri, e ciò per cui gli altri servono ancora, insostituibilmente. Meno otto e più tredici non è una contraddizione nell'umore della comunità verso l'AI. È la formulazione più precisa di quell'umore che abbia visto in tutto l'anno.