Note dal lavoro — Nicola Vitrani https://www.nicolavitrani.it/articoli/ Appunti tecnici su frontend, backend, vibe coding e agenti AI. it API sicure da ripetere: idempotenza e retry https://www.nicolavitrani.it/articoli/api-idempotenza-retry-sicuri/ https://www.nicolavitrani.it/articoli/api-idempotenza-retry-sicuri/ Sat, 24 Oct 2026 07:00:00 GMT Backend Cosa succede quando una richiesta riesce ma la risposta si perde: Idempotency-Key, vincoli univoci e come evitare ordini duplicati. Leggere EXPLAIN in MySQL senza paura (e scegliere l’indice giusto) https://www.nicolavitrani.it/articoli/mysql-explain-indici/ https://www.nicolavitrani.it/articoli/mysql-explain-indici/ Sat, 24 Oct 2026 07:00:00 GMT Backend Le quattro colonne di EXPLAIN che contano, i motivi per cui un indice non viene usato e come costruire un indice composto per una query reale. Code e job in Laravel: spostare il lavoro lento fuori dalla richiesta https://www.nicolavitrani.it/articoli/laravel-code-job/ https://www.nicolavitrani.it/articoli/laravel-code-job/ Sat, 24 Oct 2026 07:00:00 GMT Backend Dispatch, tentativi, backoff e job falliti: come usare le code di Laravel in modo affidabile e cosa controllare dopo ogni deploy. Prompt per agenti di coding: criteri di accettazione, non desideri https://www.nicolavitrani.it/articoli/prompt-criteri-di-accettazione/ https://www.nicolavitrani.it/articoli/prompt-criteri-di-accettazione/ Sat, 24 Oct 2026 07:00:00 GMT AI Un prompt efficace descrive come verificare il risultato. Una struttura semplice con contesto, vincoli e controlli concreti. Git con gli agenti AI: branch, commit piccoli e come tornare indietro https://www.nicolavitrani.it/articoli/git-con-agenti-ai/ https://www.nicolavitrani.it/articoli/git-con-agenti-ai/ Sat, 24 Oct 2026 07:00:00 GMT AI Come usare Git per lavorare in fretta con un agente senza paura di rompere qualcosa: branch dedicati, diff letto e comandi da non delegare. Vibe coding con criterio: dalla scintilla al codice che puoi mantenere https://www.nicolavitrani.it/articoli/vibe-coding-con-criterio/ https://www.nicolavitrani.it/articoli/vibe-coding-con-criterio/ Sat, 24 Oct 2026 07:00:00 GMT AI Come lavoro con un agente AI senza perdere il controllo: vincoli prima del codice, passi piccoli, diff letto per intero e un commit solo quando sono io a dirlo. Scrivere istruzioni per un agente: CLAUDE.md, AGENTS.md e regole di Cursor https://www.nicolavitrani.it/articoli/istruzioni-per-agenti-claude-agents-cursor/ https://www.nicolavitrani.it/articoli/istruzioni-per-agenti-claude-agents-cursor/ Sat, 24 Oct 2026 07:00:00 GMT AI Cosa mettere nel file di istruzioni che l’agente legge a ogni sessione, come tenerlo corto e come far diventare ogni errore ripetuto una riga utile. Verificare il lavoro di un agente: se non l’hai misurato, non è finito https://www.nicolavitrani.it/articoli/verificare-il-lavoro-di-un-agente/ https://www.nicolavitrani.it/articoli/verificare-il-lavoro-di-un-agente/ Sat, 24 Oct 2026 07:00:00 GMT AI Tre errori reali capitati lavorando con un agente AI su questo sito e le verifiche che li avrebbero intercettati prima: build, ambiente di sviluppo, screenshot e metriche. Cursor, Claude Code o Codex: come scegliere lo strumento giusto https://www.nicolavitrani.it/articoli/cursor-claude-code-codex-come-scegliere/ https://www.nicolavitrani.it/articoli/cursor-claude-code-codex-come-scegliere/ Sat, 24 Oct 2026 07:00:00 GMT AI Un criterio per scegliere tra editor con AI integrata e agenti da terminale o cloud: dove lavori, quanto controllo vuoi, quanto dura il compito e cosa puoi condividere. Query N+1 in Laravel: come riconoscerle e toglierle https://www.nicolavitrani.it/articoli/laravel-query-n-piu-1/ https://www.nicolavitrani.it/articoli/laravel-query-n-piu-1/ Sat, 24 Oct 2026 07:00:00 GMT Backend Il problema più comune delle pagine lente in Laravel: come individuarlo, come risolverlo con l’eager loading e come far fallire i lazy load accidentali in sviluppo. Paginazione in Laravel: offset o cursore? https://www.nicolavitrani.it/articoli/paginazione-offset-o-cursore-laravel/ https://www.nicolavitrani.it/articoli/paginazione-offset-o-cursore-laravel/ Sat, 24 Oct 2026 07:00:00 GMT Backend paginate, simplePaginate e cursorPaginate a confronto: costo reale, comportamento quando i dati cambiano e quale scegliere per una tabella, un feed o un’API. Quando togliere un effetto: da three.js a una griglia di punti in CSS https://www.nicolavitrani.it/articoli/dal-3d-alla-griglia-di-punti/ https://www.nicolavitrani.it/articoli/dal-3d-alla-griglia-di-punti/ Sat, 24 Oct 2026 07:00:00 GMT Frontend Perché ho sostituito un reticolo 3D in three.js con una griglia di punti in CSS nella hero del mio portfolio, e cosa ho imparato sul peso visivo e tecnico di un effetto. Testo che si illumina allo scroll: come non rompere il contrasto https://www.nicolavitrani.it/articoli/testo-che-si-illumina-contrasto/ https://www.nicolavitrani.it/articoli/testo-che-si-illumina-contrasto/ Sat, 24 Oct 2026 07:00:00 GMT Frontend Un effetto di lettura progressiva parte da parole quasi invisibili: cosa chiede WCAG sul contrasto, come l’ho misurato con Lighthouse e quale opacità minima ho scelto. Rendere indicizzabile una SPA React con Vite: prerender, lingue e sitemap https://www.nicolavitrani.it/articoli/spa-react-prerender-lingue-sitemap/ https://www.nicolavitrani.it/articoli/spa-react-prerender-lingue-sitemap/ Sat, 24 Oct 2026 07:00:00 GMT Frontend Come ho trasformato un portfolio React a pagina singola in pagine statiche per lingua, con canonical, hreflang, sitemap generata in build e qualche ottimizzazione di caricamento.