[{"data":1,"prerenderedAt":1030},["ShallowReactive",2],{"post-git-ingest-trasforma-repository-github-in-testo-per-llm":3,"related-git-ingest-trasforma-repository-github-in-testo-per-llm":216},{"id":4,"title":5,"body":6,"categories":199,"coverImage":201,"date":202,"description":203,"extension":204,"meta":205,"navigation":206,"path":207,"seo":208,"stem":209,"sticky":210,"tags":211,"__hash__":215},"articles/git-ingest-trasforma-repository-github-in-testo-per-llm.md","GitIngest: repository GitHub in testo per sfruttare al massimo gli LLM nell'analisi, debug e documentazione del codice",{"type":7,"value":8,"toc":187},"minimark",[9,16,19,26,31,34,50,54,57,60,80,84,87,102,105,109,145,149,152,163,167,170,173,177],[10,11,12],"p",{},[13,14,15],"strong",{},"Come sfruttare GitIngest per migliorare l’assistenza al codice con i modelli di linguaggio (LLM)",[10,17,18],{},"Negli ultimi anni, i modelli di linguaggio di grandi dimensioni (LLM) come GPT si sono rivelati strumenti potentissimi per supportare sviluppatori e team di programmazione. Dalla generazione automatica di codice all’analisi e al debug, gli LLM possono analizzare grandi quantità di testo e fornire soluzioni intelligenti. Tuttavia, per sfruttare al meglio queste potenzialità, è essenziale fornire al modello il contesto giusto, come una rappresentazione completa e leggibile del codice sorgente.",[10,20,21,22,25],{},"Ed è qui che entra in gioco ",[13,23,24],{},"GitIngest",": uno strumento progettato per semplificare il processo di integrazione dei repository GitHub nei modelli di linguaggio.",[27,28,30],"h3",{"id":29},"cosè-gitingest","Cos’è GitIngest?",[10,32,33],{},"GitIngest è un servizio che consente di trasformare qualsiasi repository GitHub in una rappresentazione testuale del suo contenuto, rendendolo immediatamente fruibile per applicazioni che utilizzano gli LLM. Con un semplice cambio nell’URL di un repository GitHub, puoi ottenere una versione testuale del codice sorgente che può essere elaborata da modelli di intelligenza artificiale per:",[35,36,37,41,44,47],"ul",{},[38,39,40],"li",{},"Generare documentazione tecnica.",[38,42,43],{},"Analizzare il funzionamento di un progetto.",[38,45,46],{},"Suggerire miglioramenti o refactoring.",[38,48,49],{},"Risolvere bug complessi.",[27,51,53],{"id":52},"perché-trasformare-il-codice-in-testo-è-utile-per-gli-llm","Perché trasformare il codice in testo è utile per gli LLM?",[10,55,56],{},"I modelli di linguaggio lavorano su dati testuali: il loro “punto di forza” è comprendere e generare testo in linguaggio naturale o in formati specifici (come il codice). Tuttavia, la struttura complessa di un repository – con file, directory e formati diversi – può rappresentare un ostacolo per un modello di intelligenza artificiale.",[10,58,59],{},"GitIngest rende il codice e la struttura di un progetto immediatamente leggibili e utilizzabili, eliminando la necessità di preparare manualmente i dati. Questo è particolarmente utile per:",[35,61,62,68,74],{},[38,63,64,67],{},[13,65,66],{},"Addestramento personalizzato",": vuoi creare un chatbot che capisca il tuo software? Fornisci il repository al modello tramite GitIngest per insegnargli le specificità del tuo progetto.",[38,69,70,73],{},[13,71,72],{},"Debug assistito",": trasforma il codice in un formato comprensibile per chiedere suggerimenti direttamente al modello.",[38,75,76,79],{},[13,77,78],{},"Analisi di grandi codebase",": grazie alla trasformazione testuale, anche i progetti più complessi diventano accessibili agli LLM per analisi approfondite.",[27,81,83],{"id":82},"come-funziona-gitingest","Come funziona GitIngest?",[10,85,86],{},"Utilizzare GitIngest è semplicissimo. Basta sostituire \"github.com\" con \"gitingest.com\" nell'URL di un repository. Ad esempio:",[35,88,89,96],{},[38,90,91,92],{},"URL originale: ",[93,94,95],"code",{},"https://github.com/utente/progetto",[38,97,98,99],{},"URL GitIngest: ",[93,100,101],{},"https://gitingest.com/utente/progetto",[10,103,104],{},"Accedendo a questo nuovo link, otterrai un file testuale che rappresenta il codice e la struttura del repository. Puoi anche configurare il processo per includere o escludere specifici file o directory, in modo da focalizzarti solo sulle parti più rilevanti.",[27,106,108],{"id":107},"casi-duso-di-gitingest-con-gli-llm","Casi d’uso di GitIngest con gli LLM",[110,111,112,121,129,137],"ol",{},[38,113,114,117,120],{},[13,115,116],{},"Documentazione automatizzata",[118,119],"br",{},"\nGli LLM possono generare descrizioni dettagliate di funzioni, metodi e interi progetti se hanno accesso al codice sorgente. Con GitIngest, puoi fornire loro una base completa per creare documentazione leggibile e aggiornata.",[38,122,123,126,128],{},[13,124,125],{},"Supporto alla manutenzione del codice",[118,127],{},"\nIn team distribuiti o su progetti legacy, gli LLM possono analizzare il codice estratto con GitIngest per suggerire miglioramenti o identificare vulnerabilità.",[38,130,131,134,136],{},[13,132,133],{},"Onboarding di nuovi sviluppatori",[118,135],{},"\nFornire ai nuovi membri del team un riassunto chiaro di un progetto è spesso complesso. Con GitIngest e un LLM, puoi generare sintesi, diagrammi di flusso o spiegazioni passo-passo direttamente dal codice.",[38,138,139,142,144],{},[13,140,141],{},"Debug e troubleshooting più rapidi",[118,143],{},"\nPassare il codice a un LLM consente di chiedere assistenza diretta su errori o inefficienze. Puoi anche sottoporre porzioni del repository per ottenere suggerimenti mirati.",[27,146,148],{"id":147},"un-esempio-pratico","Un esempio pratico",[10,150,151],{},"Immagina di lavorare su un progetto open source complesso, come un’implementazione di un framework web. Puoi utilizzare GitIngest per trasformare l’intero repository in testo, quindi caricarlo in un LLM per:",[35,153,154,157,160],{},[38,155,156],{},"Identificare parti di codice ridondanti.",[38,158,159],{},"Suggerire ottimizzazioni di performance.",[38,161,162],{},"Proporre nuove funzionalità basandosi sulle linee esistenti.",[27,164,166],{"id":165},"perché-scegliere-gitingest","Perché scegliere GitIngest?",[10,168,169],{},"GitIngest è stato sviluppato per offrire flessibilità e velocità. Grazie alla possibilità di personalizzare il processo di estrazione, è uno strumento ideale sia per singoli sviluppatori che per team tecnici che vogliono potenziare il proprio workflow.",[10,171,172],{},"Inoltre, GitIngest è supportato da una comunità attiva su Discord, dove gli utenti possono scambiarsi consigli e best practice.",[27,174,176],{"id":175},"provalo-subito","Provalo subito!",[10,178,179,180,186],{},"Se vuoi sfruttare al massimo i modelli di linguaggio per la gestione del tuo codice, GitIngest è la soluzione ideale. Scopri di più e inizia oggi stesso visitando ",[181,182,24],"a",{"href":183,"rel":184},"https://gitingest.com/",[185],"nofollow",".",{"title":188,"searchDepth":189,"depth":189,"links":190},"",2,[191,193,194,195,196,197,198],{"id":29,"depth":192,"text":30},3,{"id":52,"depth":192,"text":53},{"id":82,"depth":192,"text":83},{"id":107,"depth":192,"text":108},{"id":147,"depth":192,"text":148},{"id":165,"depth":192,"text":166},{"id":175,"depth":192,"text":176},[200],"dev","https://i2.wp.com/enricodeleo.s3.eu-south-1.amazonaws.com/images/gitingest.jpg","2025-01-06T22:12:00.000Z","Scopri come GitIngest trasforma i repository GitHub in testo leggibile per modelli di linguaggio (LLM), facilitando analisi, debug e generazione automatica di documentazione del codice.","md",{},true,"/git-ingest-trasforma-repository-github-in-testo-per-llm",{"title":5,"description":203},"git-ingest-trasforma-repository-github-in-testo-per-llm",false,[212,213,200,214],"AI","LLM","coding","_kVARkdSb0JdI9EhcpD1MtiFh3o62XLwnXwSmlLh4Rg",[217,680],{"id":218,"title":219,"body":220,"categories":664,"coverImage":667,"date":668,"description":227,"extension":204,"meta":669,"navigation":206,"path":670,"seo":671,"stem":672,"sticky":210,"tags":673,"__hash__":679},"articles/bullmq-rs-porting.md","L'interfaccia che non si vede",{"type":7,"value":221,"toc":653},[222,228,235,241,244,249,252,257,264,267,270,274,277,280,287,290,293,304,307,311,314,322,329,336,339,342,356,363,367,370,431,446,460,463,466,470,473,516,519,522,526,529,535,542,548,551,562,567,571,578,581,596,599,602,605,608,611,614,620,623,626,630,648],[10,223,224],{},[225,226,227],"em",{},"Un porting non è una traduzione. È un esercizio di scoperta su cosa, in un sistema, è davvero il contratto. Quasi sempre non è quello che pensi.",[10,229,230,231,234],{},"Qualche giorno fa è stato mergiato in upstream un PR che ho aperto su ",[93,232,233],{},"bullmq-rs",", il porting Rust di BullMQ. Il diff è grosso — circa undicimila righe in più, duemila in meno — ed esce come release v2.0.0 breaking.",[10,236,237,238,186],{},"Quando ho riletto la description del PR a cose fatte, mi sono accorto che la sezione più informativa non era quella di cosa il PR includeva. Era quella di ",[13,239,240],{},"cosa avevo deliberatamente lasciato fuori",[10,242,243],{},"È l'unica cosa per cui valga la pena scriverci sopra.",[245,246,248],"h2",{"id":247},"cosè-successo","Cos'è successo",[10,250,251],{},"BullMQ è una libreria Node per code distribuite sopra Redis. È diffusa, ha un ecosistema consolidato attorno — Bull Board, dashboard, monitoring — e ha una specifica di fatto su come i dati sono strutturati dentro Redis. Non c'è uno standard formale: c'è il codice della libreria, e c'è il comportamento che il tooling esterno si aspetta di osservare.",[10,253,254,256],{},[93,255,233],{}," è il porting Rust. L'idea è semplice: chi vuole worker in Rust dovrebbe poter scrivere worker in Rust senza dover rifare l'infrastruttura attorno. La dashboard resta quella. I job creati da Node sono leggibili da Rust, e viceversa. Le metriche continuano a funzionare. Si può migrare un servizio per volta senza spegnere il resto.",[10,258,259,260,263],{},"Quando il porting esisteva nella versione precedente, l'API Rust si era avvicinata a quella di BullMQ ma il ",[13,261,262],{},"wire format"," — la struttura esatta dei dati che finiscono su Redis — era divergente in modi sottili. Liste dove dovevano esserci sorted set. Campi degli hash con nomi diversi. Eventi sullo stream con payload diverso da quello che il tooling Node si aspetta di leggere.",[10,265,266],{},"Risultato concreto: il tooling esterno non funzionava. Bull Board non vedeva le code create da Rust. Un worker Node sulla stessa coda di un worker Rust non vedeva i job dell'altro.",[10,268,269],{},"L'API Rust era pulita. Quello che usciva da Redis era un'altra cosa.",[245,271,273],{"id":272},"lo-scenario-per-cui-serve","Lo scenario per cui serve",[10,275,276],{},"Per essere concreti, lo scenario tipico è questo.",[10,278,279],{},"Hai un sistema Node con BullMQ in produzione. Funziona. Bull Board ti mostra le code, gli alert sono cablati, l'SRE sa dove guardare quando qualcosa fuma di notte.",[10,281,282,283,286],{},"A un certo punto un tipo di job smette di reggere. Encoding di video. Image processing. Una pipeline CPU-bound. Il worker Node fa quello che può, ma il throughput non basta più. Vorresti riscrivere ",[225,284,285],{},"solo quel worker"," in Rust, lasciando il resto dell'infrastruttura dov'è.",[10,288,289],{},"Senza wire compatibility, le opzioni sono due. Riscrivere tutto in Rust e perdere il tooling Node. Oppure tenere un layer di traduzione tra i due e portarsi dietro la complessità di mantenerlo allineato a ogni release di BullMQ.",[10,291,292],{},"Con wire compatibility, c'è una terza opzione. Lo stesso job prodotto da un producer Node viene processato da un worker Rust. La dashboard non sa che la stanno chiamando da due runtime diversi. Le metriche non cambiano forma. L'SRE che riceve la pagine alle tre vede le stesse cose che vedeva prima.",[10,294,295,296,299,300,303],{},"C'è anche una proprietà che in Rust emerge naturalmente e in Node non esiste: il payload del job è tipizzato. Scrivi ",[93,297,298],{},"Job\u003CEncodingTask>"," e il worker riceve la ",[93,301,302],{},"EncodingTask"," già deserializzata, controllata a compile time. Se cambi lo schema, il compilatore ti ferma prima del deploy. Per i job dove la correttezza del payload conta davvero — pagamenti, side effect costosi, transizioni di stato critiche — è una garanzia concreta, non un dettaglio estetico.",[10,305,306],{},"Non è un caso d'uso da keynote. È uno di quelli che fa la differenza dopo il deploy.",[245,308,310],{"id":309},"hyrums-law-applicata-al-porting","Hyrum's Law applicata al porting",[10,312,313],{},"C'è una formulazione attribuita a Hyrum Wright, che ha lavorato a lungo in Google sul tooling di refactor su larga scala:",[315,316,317],"blockquote",{},[10,318,319],{},[225,320,321],{},"With a sufficient number of users of an API, it does not matter what you promise in the contract: all observable behaviors of your system will be depended on by somebody.",[10,323,324,325,328],{},"In italiano stretto: con abbastanza utenti, ",[13,326,327],{},"non conta cosa dici di promettere",". Conta tutto quello che il sistema fa, comprese le parti che non avresti scelto di promettere. Qualcuno, da qualche parte, si è appoggiato a ognuna di quelle.",[10,330,331,332,335],{},"In un porting, questa frase ha un corollario molto preciso: l'interfaccia vera del sistema che stai portando ",[13,333,334],{},"non è la sua API",". È l'insieme dei comportamenti osservabili dall'esterno — strutture dati, formati di serializzazione, side effect, ordine degli eventi — su cui qualcun altro, fuori dal sistema, si è appoggiato per far funzionare le sue cose.",[10,337,338],{},"Per BullMQ quell'interfaccia è il layout su Redis. Non la signature di una funzione. La forma esatta di un hash, di una sorted set, di una entry su uno stream.",[10,340,341],{},"Quando porti un sistema così, le scelte si dividono in due categorie:",[110,343,344,350],{},[38,345,346,349],{},[13,347,348],{},"Quello che non puoi cambiare"," — il wire format. Cambiarlo significa rompere ogni cosa che ci sta sopra senza che il chiamante se ne accorga, fino al prossimo deploy in cui scopre che la dashboard è vuota o che mancano metà dei job.",[38,351,352,355],{},[13,353,354],{},"Quello che puoi cambiare"," — l'API del linguaggio di destinazione. È libera. Nessuno la sta osservando dall'esterno.",[10,357,358,359,362],{},"Confondere le due categorie è il modo più sicuro di fare un porting che ",[225,360,361],{},"sembra finito"," e non lo è.",[245,364,366],{"id":365},"cosa-il-pr-ha-messo-dentro","Cosa il PR ha messo dentro",[10,368,369],{},"La prima parte del lavoro è stata appiattire il wire format sotto quello di BullMQ v5:",[35,371,372,385,406,409,412],{},[38,373,374,375,378,379,378,382],{},"liste per ",[93,376,377],{},"wait",", ",[93,380,381],{},"active",[93,383,384],{},"paused",[38,386,387,388,378,391,378,394,378,397,378,400,378,403],{},"sorted set per ",[93,389,390],{},"prioritized",[93,392,393],{},"delayed",[93,395,396],{},"completed",[93,398,399],{},"failed",[93,401,402],{},"waiting-children",[93,404,405],{},"marker",[38,407,408],{},"hash per i metadati",[38,410,411],{},"stream per gli eventi",[38,413,414,415,378,418,378,421,378,424,378,427,430],{},"campi degli hash dei job con gli stessi nomi e gli stessi formati di Node (",[93,416,417],{},"atm",[93,419,420],{},"ats",[93,422,423],{},"processedOn",[93,425,426],{},"pb",[93,428,429],{},"opts"," JSON-encoded)",[10,432,433,434,436,437,439,440,442,443,445],{},"Sopra, il porting degli script Lua atomici che BullMQ usa per le transizioni di stato. Una transizione di un job — da ",[93,435,377],{}," ad ",[93,438,381],{},", da ",[93,441,381],{}," a ",[93,444,396],{},", dal recovery di un job stallato — non si può implementare come sequenza di comandi Redis. Deve essere atomica, e BullMQ ottiene l'atomicità delegando a Lua. Riscriverle a mano in Rust significherebbe inventare race condition che il codice originale non ha. Quindi si portano, riga per riga, e si verifica che il comportamento osservato sia identico.",[10,447,448,449,452,453,456,457,459],{},"Sopra ancora c'è il runtime: marker-based loop con ",[93,450,451],{},"BZPOPMIN",", lock con token e TTL, recovery dei job stallati, fast-path per il ",[93,454,455],{},"moveToFinished",", fix del prefetch perché i job non rimangano orfani in ",[93,458,381],{}," quando un worker si chiude in modo non pulito.",[10,461,462],{},"Sopra ancora le API Rust: Queue, Job, QueueEvents, FlowProducer con parent/child cross-queue.",[10,464,465],{},"Tutto questo è abbastanza per usarlo in produzione, e abbastanza perché parli con un cluster Node esistente senza traduzioni intermedie.",[245,467,469],{"id":468},"cosa-il-pr-ha-deliberatamente-lasciato-fuori","Cosa il PR ha deliberatamente lasciato fuori",[10,471,472],{},"Una lista, nel corpo del PR:",[35,474,475,482,501,504,507,510,513],{},[38,476,477,478,481],{},"niente ",[93,479,480],{},"JobScheduler"," (i job ripetibili tipo cron)",[38,483,484,485,378,488,378,491,378,494,378,497,500],{},"niente bulk sulle Queue (",[93,486,487],{},"addBulk",[93,489,490],{},"clean",[93,492,493],{},"obliterate",[93,495,496],{},"retryJobs",[93,498,499],{},"promoteJobs",")",[38,502,503],{},"niente pause/resume lato Worker (sulla Queue sì)",[38,505,506],{},"niente rate limiting",[38,508,509],{},"niente deduplica",[38,511,512],{},"niente debounce",[38,514,515],{},"niente metriche",[10,517,518],{},"Sono tutte cose che BullMQ ha. Sono tutte cose che andranno aggiunte.",[10,520,521],{},"Ma non in questo PR.",[245,523,525],{"id":524},"perché","Perché",[10,527,528],{},"Perché un porting che prova a fare tutto in un colpo solo finisce in due modi: o non viene mai mergiato, o viene mergiato con compromessi nascosti.",[10,530,531,532,186],{},"I compromessi nascosti sono quelli che non vedi nella description ma sono nel codice. Convenzioni inventate dove la spec non era chiara. Edge case lasciati indietro perché stancavano. Comportamenti che divergono in silenzio da quelli del sistema originale e che si scoprono mesi dopo, quando un utente segnala che ",[225,533,534],{},"\"con Node funziona, con Rust no\"",[10,536,537,538,541],{},"È il debito ",[225,539,540],{},"accidentale"," di Cunningham — quello che accumuli senza saperlo, perché non hai capito abbastanza bene il problema. Non puoi quantificarlo. Non puoi ripagarlo. Non sai nemmeno dove sia.",[10,543,544,545,186],{},"Il modo per evitarlo, in un porting, è invertire l'istinto: ",[13,546,547],{},"dichiarare per primo quello che non stai facendo",[10,549,550],{},"Non in fondo al PR, in piccolo. Nella description, in una sezione dedicata, con i nomi precisi delle API e dei comportamenti che mancano. Pubblicamente, prima ancora che qualcuno chieda.",[10,552,553,554,557,558,561],{},"Questo trasforma la stessa identica situazione — ",[225,555,556],{},"\"una libreria con feature mancanti\""," — da debito accidentale in ",[13,559,560],{},"debito deliberato",": lo strumento legittimo di cui Cunningham parlava davvero. So cosa manca. È scritto. È tracciato. Il prossimo PR sa dove deve atterrare. Chi usa la libreria sa cosa può aspettarsi e cosa no.",[315,563,564],{},[10,565,566],{},"Il debito deliberato è uno strumento di scope. Il debito accidentale è scope che ti gestisce.",[245,568,570],{"id":569},"la-tentazione-di-portare-tutto","La tentazione di portare tutto",[10,572,573,574,577],{},"C'è una tentazione precisa, in qualunque porting o reimplementazione, ed è la stessa che la velocità di produzione dell'AI rende più facile da assecondare: provare a fare ",[225,575,576],{},"tutto"," in un colpo solo, perché tecnicamente si potrebbe.",[10,579,580],{},"Il sistema originale ha cento feature. Il porting può imitarle tutte. Le LOC scalano. Il PR si gonfia. La review diventa impossibile. Le scelte sulle parti che non hai capito davvero finiscono per essere prese per default — dal codice generato, da analogie con altri sistemi, da quello che sembrava ragionevole alle tre di notte.",[10,582,583,584,587,588,591,592,595],{},"E quando quel PR viene mergiato, il sistema risultante ha un'estensione paragonabile all'originale ma una superficie di bug che nessuno ha mappato. ",[225,585,586],{},"Sembra"," completo. E come ho scritto altrove, ",[225,589,590],{},"sembra completo"," ed ",[225,593,594],{},"è corretto"," non sono mai stati la stessa cosa.",[10,597,598],{},"L'alternativa è meno glamour. Portare prima ciò che è strutturale — il wire format, il runtime, gli atomi — e poi aggiungere superficie un pezzo alla volta, additivamente, scrivendo nero su bianco cosa manca ancora e perché.",[10,600,601],{},"Niente dimostra qualcosa nel portare di più. Qualcosa si perde quasi sempre nel portare senza dichiarare cosa è dentro e cosa è fuori.",[245,603,219],{"id":604},"linterfaccia-che-non-si-vede",[10,606,607],{},"Vale anche fuori dai porting.",[10,609,610],{},"In quasi tutti i sistemi che condividono stato con qualcosa di esterno — un'altra applicazione, un altro team, un altro runtime, un altro linguaggio — l'interfaccia che conta davvero non è quella che vedi nella signature di una funzione. È quella che attraversa il confine. Un payload JSON. Una riga di una tabella. Un evento su una stream.",[10,612,613],{},"È quella che il chiamante osserva. È quella che, se cambia in silenzio, rompe le cose lontano da dove l'hai cambiata, in un orario in cui non sei davanti allo schermo.",[10,615,616,617],{},"Quando lavori dentro un sistema chiuso, hai il lusso di poter rinominare, ristrutturare, refattorizzare a piacere. Quando il sistema ha un confine osservato da qualcun altro, quel lusso scompare. ",[13,618,619],{},"L'API del linguaggio è effimera. Il contratto reale è quello che passa attraverso il confine.",[10,621,622],{},"Per il porting di BullMQ quel confine era Redis. Una volta che il confine è giusto, tutto il resto è additivo. Se il confine è sbagliato, ogni feature aggiunta sopra è una bugia in più da mantenere.",[10,624,625],{},"E le bugie nei sistemi non scadono. Aspettano.",[245,627,629],{"id":628},"riferimenti","Riferimenti",[35,631,632,640],{},[38,633,634,635],{},"PR mergiato: ",[181,636,639],{"href":637,"rel":638},"https://github.com/bogardt/bullmq-rs/pull/3",[185],"bogardt/bullmq-rs#3",[38,641,642,643],{},"Issue di partenza: ",[181,644,647],{"href":645,"rel":646},"https://github.com/bogardt/bullmq-rs/issues/2",[185],"bogardt/bullmq-rs#2",[10,649,650],{},[225,651,652],{},"Il porting più onesto è quello che dichiara per primo cosa non sta portando.",{"title":188,"searchDepth":189,"depth":189,"links":654},[655,656,657,658,659,660,661,662,663],{"id":247,"depth":189,"text":248},{"id":272,"depth":189,"text":273},{"id":309,"depth":189,"text":310},{"id":365,"depth":189,"text":366},{"id":468,"depth":189,"text":469},{"id":524,"depth":189,"text":525},{"id":569,"depth":189,"text":570},{"id":604,"depth":189,"text":219},{"id":628,"depth":189,"text":629},[665,666],"Dev","Open Source","https://i2.wp.com/enricodeleo.s3.eu-south-1.amazonaws.com/images/linterfaccia-che-non-si-vede.png","2026-06-07T10:00:00.000Z",{},"/bullmq-rs-porting",{"title":219,"description":227},"bullmq-rs-porting",[674,675,676,677,678],"rust","bullmq","open-source","porting","engineering","UuZirdWSmow4buT9WfQq0g6y2oE8l0x6cPdqDavWfHg",{"id":681,"title":682,"body":683,"categories":1017,"coverImage":1018,"date":1019,"description":1020,"extension":204,"meta":1021,"navigation":206,"path":1022,"seo":1023,"stem":1024,"sticky":210,"tags":1025,"__hash__":1029},"articles/velocita-senza-giudizio.md","Velocità senza giudizio",{"type":7,"value":684,"toc":1008},[685,690,693,700,703,706,711,718,722,725,732,745,752,758,761,765,771,778,781,792,795,802,810,813,817,820,827,838,841,848,853,856,859,866,870,873,876,879,882,888,891,896,899,903,909,912,919,922,933,937,943,946,956,961,964,967,972,976,979,986,989,1000,1003],[10,686,687],{},[225,688,689],{},"Il vibe coding non ha inventato il codice scritto male. Ha solo tolto l'attrito.",[10,691,692],{},"Ho visto un backend con l'autenticazione hardcodata nel frontend. Password admin in chiaro, visibile a chiunque aprisse DevTools. Non era vibe coding — era 2018, dev umani, trovati su Upwork.",[10,694,695,696,699],{},"Ve lo dico perché quello che sta succedendo adesso ",[13,697,698],{},"non è una novità",". È la stessa roba, più veloce.",[10,701,702],{},"Ho visto Google Sheets usato come database. Collassava a quattro utenti. I fondatori si sono sorpresi.",[10,704,705],{},"Ho visto funzionalità dichiarate implementate che erano solo API vuote senza niente dietro. L'ho visto fare a dev umani. L'ho visto fare a Claude Opus 4.6, che in questo momento è il modello più capace di Anthropic. Ho visto test scritti per passare, non per verificare.",[315,707,708],{},[10,709,710],{},"Un sistema che si auto-certifica è più pericoloso di uno che fallisce apertamente.",[10,712,713,714,717],{},"Il problema non è l'AI. È che la velocità che offre può farti dimenticare che costruire software è ",[13,715,716],{},"fondamentalmente un atto cognitivo"," — non di scrittura.",[245,719,721],{"id":720},"il-software-non-è-testo","Il software non è testo",[10,723,724],{},"Questa è la cosa che l'entusiasmo attorno al vibe coding dimentica sistematicamente.",[10,726,727,728,731],{},"Il software non è testo. È un ",[13,729,730],{},"modello formale della realtà"," — un sistema di regole che descrive come un dominio si comporta, come gli stati cambiano, come le eccezioni vengono gestite, come il tempo e la concorrenza e il fallimento vengono trattati.",[10,733,734,735,738,739,741,742,186],{},"Scrivere codice non è mai stato il problema difficile. Il problema difficile è capire ",[225,736,737],{},"cosa"," scrivere — e ",[225,740,524],{},". È identificare i confini del dominio, le invarianti che devono reggere, i casi limite che il business non ti ha detto perché non sapeva di doverlo fare, le implicazioni che una scelta architetturale avrà tra sei mesi quando i requisiti cambieranno — ",[13,743,744],{},"perché cambiano sempre",[10,746,747,748,751],{},"Questa comprensione non si ottiene velocemente. Si ottiene attraverso iterazioni, conversazioni, errori, correzioni, notti a chiedersi perché quella cosa non funziona come dovrebbe. È quella che Michael Polanyi chiamava ",[225,749,750],{},"conoscenza tacita"," — sapere che non si riesce a trasferire completamente in parole, che risiede nell'esperienza accumulata, nei pattern riconosciuti, nelle intuizioni costruite su decine di progetti.",[10,753,754,757],{},[13,755,756],{},"L'AI non ha questa conoscenza."," Ha la media statistica di quello che è stato scritto su internet riguardo a problemi simili al tuo.",[10,759,760],{},"Che non è la stessa cosa.",[245,762,764],{"id":763},"la-trappola-della-perfezione-apparente","La trappola della perfezione apparente",[10,766,767,768,186],{},"C'è qualcosa di specifico nell'AI che aggrava tutto questo: ",[13,769,770],{},"il codice che produce sembra sempre scritto bene",[10,772,773,774,777],{},"È ben nominato, ha i commenti nei posti giusti, segue le convenzioni, usa i pattern corretti. Non sembra il codice di qualcuno che non sa quello che fa — sembra il codice di qualcuno che sa ",[225,775,776],{},"esattamente"," quello che fa.",[10,779,780],{},"Questo è il problema.",[10,782,783,784,787,788,791],{},"Il codice sbagliato scritto male ti ferma. Lo vedi, lo senti, ti insospettisce. Attiva il tuo senso critico prima ancora che tu abbia capito cosa fa. Il ",[13,785,786],{},"codice sbagliato scritto bene"," attraversa la code review senza attivare nessun campanello d'allarme, supera i test, va in produzione. E quando si rompe — ",[225,789,790],{},"perché si rompe"," — la forma corretta del codice rende ancora più difficile localizzare il problema concettuale che ci sta sotto.",[10,793,794],{},"Stai cercando un bug in codice che non sembra buggy. Stai cercando un'assunzione sbagliata in codice che sembra ragionevole.",[10,796,797,798,801],{},"Nel 1986 Fred Brooks scriveva che la difficoltà essenziale del software non è accidentale — non riguarda la sintassi, i compilatori, la velocità di scrittura. Riguarda la ",[13,799,800],{},"complessità concettuale intrinseca"," dei sistemi che costruiamo. Quarant'anni dopo, l'AI ha eliminato quasi completamente la difficoltà accidentale. Quella essenziale è rimasta intatta.",[315,803,804],{},[10,805,806,809],{},[225,807,808],{},"\"No silver bullet.\"","\n— Fred Brooks, 1986",[10,811,812],{},"E ora che la difficoltà accidentale è sparita, la difficoltà essenziale è più esposta che mai. Ma è anche più facile da non vedere, perché l'output che la nasconde sembra così convincente.",[245,814,816],{"id":815},"il-modello-della-realtà","Il modello della realtà",[10,818,819],{},"Quando chiedi all'AI di costruire qualcosa, quello che ricevi non è una soluzione.",[10,821,822,823,826],{},"È una ",[13,824,825],{},"interpretazione"," del problema che hai descritto.",[10,828,829,830,833,834,837],{},"L'AI costruisce un modello della realtà basato su quello che gli hai detto — e quello che gli hai detto è inevitabilmente incompleto, perché la conoscenza del dominio che hai in testa non si trasferisce per intero in un prompt. Il gap tra il problema che hai ",[225,831,832],{},"in testa"," e il problema che l'AI ha ",[225,835,836],{},"capito"," è sempre presente. A volte è trascurabile. A volte è la differenza tra un sistema che regge e uno che collassa al primo caso limite reale.",[10,839,840],{},"La velocità non ti dà il tempo di misurare quel gap. Peggio: la velocità e la perfezione apparente dell'output creano attivamente l'illusione che il gap non esista.",[10,842,843,844,847],{},"Questo è il motivo per cui ",[13,845,846],{},"\"funziona\" non è mai abbastanza"," come criterio di accettazione.",[10,849,850],{},[225,851,852],{},"Funziona rispetto a cosa?",[10,854,855],{},"Rispetto ai test che l'AI ha scritto per passare — costruiti attorno agli stessi casi che aveva in testa quando ha scritto il codice, in un loop chiuso che non include nessuna realtà esterna? Rispetto alla demo con dati puliti e percorsi felici? O rispetto alla logica reale del dominio, con tutti i casi limite che solo tu conosci perché ci hai lavorato dentro?",[10,857,858],{},"Salvatore Sanfilippo ha sollevato un problema analogo sulla code review: lo stato mentale di chi scrive non è trasferibile al reviewer. Il reviewer vede il testo, non il ragionamento che ha prodotto quel testo. O puntualizza cose superficiali, oppure non comprende abbastanza da vedere il problema vero.",[10,860,861,862,865],{},"Con l'AI il problema si radicalizza: ",[13,863,864],{},"l'AI non ha stato mentale da trasferire",". Ha prodotto output ottimizzando per la coerenza interna del testo, non per la corrispondenza con la tua realtà. Il reviewer — che sei tu — deve colmare quel gap da solo. Se non ti fermi a farlo, nessuno lo farà.",[245,867,869],{"id":868},"let-it-sink","Let it sink",[10,871,872],{},"C'è una pratica che ogni ingegnere con abbastanza cicatrici ha interiorizzato: dormirci sopra.",[10,874,875],{},"Non per pigrizia. Per necessità cognitiva.",[10,877,878],{},"Il cervello umano non elabora i problemi complessi in modo lineare e sequenziale. Elabora in parallelo, spesso al di sotto della soglia della coscienza. È per questo che le soluzioni migliori arrivano sotto la doccia, in macchina, la mattina appena svegli — non davanti allo schermo quando stai cercando attivamente la risposta. I problemi che non vedi nel momento emergono dopo, quando torni con occhi freschi e il cervello ha avuto il tempo di connettere pattern che la concentrazione attiva non riesce a vedere.",[10,880,881],{},"Non è misticismo. È neuroscienze. La modalità diffusa del cervello è essenziale per l'insight, per la comprensione profonda, per accorgersi delle incongruenze che la modalità focalizzata salta perché è troppo dentro il problema.",[10,883,884,885],{},"Con l'AI quella pratica diventa ancora più importante, e ancora più facile da saltare. Perché in pochi minuti hai davanti qualcosa che sembra completo. L'effort che hai speso è minimo, quindi la sensazione di investimento è bassa, quindi la soglia per dichiararlo fatto si abbassa. ",[13,886,887],{},"Non hai faticato per arrivare lì, quindi non senti il bisogno di proteggerti dall'errore di aver faticato invano.",[10,889,890],{},"Ma \"sembra completo\" e \"è corretto\" sono due cose diverse — e la velocità di produzione dell'AI ha reso quella distinzione più sottile che mai.",[315,892,893],{},[10,894,895],{},"Fermarsi non è perdere il vantaggio della velocità. È il momento in cui verifichi che quella velocità ti abbia portato nella direzione giusta.",[10,897,898],{},"Senza quel momento, stai solo andando veloce verso il posto sbagliato — e ci arrivi prima.",[245,900,902],{"id":901},"la-code-review-non-basta","La code review non basta",[10,904,905,906,186],{},"La risposta istintiva a tutto questo è: ",[225,907,908],{},"\"per questo c'è la code review\"",[10,910,911],{},"Ma la code review, così come è praticata nella maggior parte dei team, non risolve il problema che stiamo descrivendo.",[10,913,914,915,918],{},"La code review tradizionale è ottima per trovare bug sintattici, violazioni di convenzioni, problemi di sicurezza ovvi. È molto meno efficace per valutare se le ",[13,916,917],{},"decisioni architetturali sono corrette",", se il modello del dominio rispecchia la realtà, se le assunzioni implicite nel codice sono valide.",[10,920,921],{},"Con l'AI il problema si amplifica: il codice generato è sintatticamente inattaccabile. Il reviewer scorre, non trova niente che attivi i campanelli d'allarme standard, approva. Il problema concettuale che stava sotto passa indisturbato.",[10,923,924,925,928,929,932],{},"La code review utile in questo contesto non è ",[225,926,927],{},"\"questo codice è scritto bene?\""," — quella risposta è quasi sempre sì. È ",[225,930,931],{},"\"questo codice fa quello che dovrebbe fare nel contesto del dominio reale?\""," — e per rispondere devi avere la conoscenza del dominio che l'AI non ha, devi aver capito i requisiti abbastanza da sapere cosa verificare, devi aver lasciato che la soluzione sedimentasse abbastanza da poterla vedere con distacco critico.",[245,934,936],{"id":935},"il-debito-che-non-vedi","Il debito che non vedi",[10,938,939,940,186],{},"Il debito tecnico generato senza giudizio ha una caratteristica precisa: ",[13,941,942],{},"è silenzioso",[10,944,945],{},"Non si manifesta subito. Si accumula in decisioni prese per default dall'AI che non erano le tue decisioni — ma ora sono nel codice, e il codice è in produzione. In architetture che reggono il caso d'uso che hai descritto ma non quello successivo. In assunzioni implicite che l'AI ha fatto riempiendo i gap del tuo prompt con la media di quello che ha visto in training.",[10,947,948,949,952,953,955],{},"Ward Cunningham, che il termine \"debito tecnico\" lo ha inventato, intendeva qualcosa di specifico: il debito ",[225,950,951],{},"deliberato",", contratto consapevolmente per andare più veloci ora con l'intenzione di ripagarlo dopo. Non il debito ",[225,954,540],{},", quello che accumuli senza saperlo perché non hai capito abbastanza bene il problema.",[10,957,958],{},[13,959,960],{},"Il debito deliberato è uno strumento legittimo. Il debito accidentale è ignoranza capitalizzata.",[10,962,963],{},"Il vibe coding senza giudizio produce quasi esclusivamente debito accidentale. Perché la velocità impedisce la comprensione, e senza comprensione non puoi nemmeno scegliere consapevolmente di indebitarti — ti indebiti e basta, senza saperlo, senza poterlo quantificare, senza un piano per ripagarlo.",[10,965,966],{},"E quando emerge, emerge nel momento peggiore. Quando c'è trazione. Quando ci sono utenti reali. Quando il costo di sistemare è un ordine di grandezza superiore a quello che sarebbe stato all'inizio.",[315,968,969],{},[10,970,971],{},"Il conto arriva sempre. La velocità determina solo quanto in fretta lo accumuli.",[245,973,975],{"id":974},"la-velocità-è-un-mezzo","La velocità è un mezzo",[10,977,978],{},"L'AI nello sviluppo è straordinaria. La uso ogni giorno.",[10,980,981,982,985],{},"Ma la velocità non è il fine — è un mezzo. Il fine è costruire qualcosa che ",[13,983,984],{},"rispecchi la logica che avevi in testa",", che regga i casi limite del dominio reale, che qualcuno possa capire e modificare tra un anno senza maledire chi lo ha scritto.",[10,987,988],{},"Se la velocità ti impedisce di verificare che questo sia vero, non stai andando più veloce. Stai solo sbagliando più in fretta. Con più righe di codice. Con più fiducia. Con meno possibilità di accorgertene prima che diventi costoso.",[10,990,991,992,995,996,999],{},"La differenza tra un ingegnere che usa l'AI bene e uno che la usa male non è tecnica. ",[13,993,994],{},"È cognitiva."," È la capacità di fermarsi, lasciare che le cose sedimentino, tornare con distacco critico e chiedersi: questo rispecchia davvero quello che volevo? O sto guardando qualcosa che ",[225,997,998],{},"sembra"," quello che volevo?",[10,1001,1002],{},"Sono domande scomode da fare quando hai appena passato un pomeriggio produttivo e lo schermo è pieno di codice nuovo e i test passano.",[10,1004,1005],{},[225,1006,1007],{},"Falle lo stesso.",{"title":188,"searchDepth":189,"depth":189,"links":1009},[1010,1011,1012,1013,1014,1015,1016],{"id":720,"depth":189,"text":721},{"id":763,"depth":189,"text":764},{"id":815,"depth":189,"text":816},{"id":868,"depth":189,"text":869},{"id":901,"depth":189,"text":902},{"id":935,"depth":189,"text":936},{"id":974,"depth":189,"text":975},[665,212],"https://i2.wp.com/enricodeleo.s3.eu-south-1.amazonaws.com/images/velocita-senza-giudizio.png","2026-04-03T10:00:00.000Z","Il vibe coding non ha inventato il codice scritto male. Ha solo tolto l'attrito. E la velocità, senza il tempo di valutare, produce solo errori più rapidi.",{},"/velocita-senza-giudizio",{"title":682,"description":1020},"velocita-senza-giudizio",[1026,1027,678,1028],"ai","vibe-coding","build-in-public","U75B5WaPnYhOsgue02Cp92PwZioiIXFh6SRZMrizYok",1780867863224]