17 novembre 2026

Modern Web Guidance: il modo più semplice per far scrivere all’AI codice davvero moderno (e ripulire i legacy)

Una toolchain gratuita che porta nelle risposte dell’AI le best practice aggiornate su CSS/HTML/JS e offre anche comandi deterministici per scovare e aggiornare pattern obsoleti.

Negli ultimi anni il web platform ha fatto passi enormi, ma l’AI continua spesso a rigurgitare soluzioni datate: polyfill inutili, JS dove basterebbe CSS, modali improvvisate, posizionamenti manuali. Modern Web Guidance punta a colmare questo gap: installi un pacchetto, ottieni guide operative scritte da esperti e le metti a disposizione del tuo coding agent. In più hai comandi CLI per cercare guide, recuperarle e persino scansionare un repository alla ricerca di codice “legacy” da modernizzare in modo ragionato, usando criteri come Baseline (stile badge MDN).

Negli ultimi anni CSS e JavaScript si sono arricchiti di funzionalità che fino a poco tempo fa avremmo risolto con librerie, workaround e parecchio codice “collante”. Il problema è che molti generatori di codice (o assistenti AI) tendono ancora a proporre soluzioni vecchie: calcoli manuali in JS per layout, modali gestiti come div con overlay improvvisati, posizionamenti assoluti al posto di primitive native, ecc.

Il risultato è il classico AI slop: codice che “funziona”, ma è difficile da mantenere, spesso fragile e raramente allineato a ciò che oggi la piattaforma offre nativamente.

Qui entra in gioco Modern Web Guidance: uno strumento gratuito pensato per portare nel flusso di lavoro indicazioni moderne, concrete e verificabili su HTML/CSS/JS. L’idea è semplice:

  • da un lato fornisce guide operative (in pratica “ricette” tecniche) curate da esperti;
  • dall’altro si integra con i coding agent tramite una modalità skills, così l’AI può attingere automaticamente a queste ricette quando serve;
  • in più espone comandi CLI deterministici per cercare/ripescare guide e per fare scan di un codebase alla ricerca di pattern legacy.

Installazione: 1 comando, zero setup complesso

L’avvio è volutamente minimale:

npx modern-web-guidance@latest install

L’installazione crea nel progetto una serie di file (guide in formato Markdown) e la configurazione necessaria affinché il tuo coding agent possa usarli come “conoscenza operativa” quando genera o modifica codice.

In pratica non stai aggiungendo l’ennesimo framework: stai aggiungendo un corpus di istruzioni moderne che indirizzano l’AI verso le primitive web attuali.

Perché cambia davvero la qualità del codice generato

Quando chiedi all’AI di implementare componenti UI comuni (tabella utenti, modale di modifica, popup informativi, textarea che si adatta al contenuto, ecc.), spesso ottieni:

  • JS per calcolare altezze e dimensioni che potresti gestire con CSS;
  • posizionamenti manuali (coordinate, bounding client rect, listener su scroll/resize) per UI che dovrebbe “seguire” un elemento;
  • modali che non bloccano correttamente lo scroll della pagina;
  • soluzioni verbose e fragili, difficili da estendere.

Con Modern Web Guidance l’AI tende invece a scegliere primitive moderne già disponibili sulla piattaforma:

  • <dialog> per modali reali (e non overlay artigianali)
  • Popover API quando serve
  • Anchor positioning per popup che restano ancorati all’elemento anche se il layout cambia
  • field-sizing: content (dove applicabile) per far crescere i campi in base al contenuto senza JS
  • uso ragionato di @supports e fallback, invece di “spalmare” workaround ovunque

Un esempio tipico: popup che devono seguire una riga che cambia posizione

Scenario comune: clicchi sul nome in una tabella, si apre un popup vicino al nome; poi riordini le righe (su/giù) e il popup deve seguire l’elemento giusto.

Soluzione vecchio stile (che l’AI propone spesso):

  • calcoli manuali di posizione,
  • aggiornamenti su ogni spostamento,
  • gestione di overflow/viewport a mano.

Approccio moderno: CSS Anchor Positioning. Una volta impostato l’ancoraggio, la UI resta corretta anche quando la riga si muove, e i casi di overflow diventano molto più semplici da gestire (es. cambiando una strategia di “flip” o adattamento).

Due modalità d’uso: “skills” e CLI deterministica

Modern Web Guidance non è solo “un pacchetto di documentazione”. Espone un set di comandi utili anche senza AI.

1) Search: trovare le guide rilevanti

Puoi cercare in modo anche vago e ottenere un elenco di guide correlate:

npx modern-web-guidance@latest search "animate a modal"

Output: una lista (tipicamente JSON) con ID e descrizioni delle guide pertinenti.

2) Retrieve: recuperare la guida (operativa) che ti serve

Una volta scelto l’ID, puoi estrarre la guida e leggerla o passarla a strumenti automatici:

npx modern-web-guidance@latest retrieve "animate-two-from-top-layer"

In sostanza: cerchi → recuperi la ricetta → la applichi.

3) List: vedere tutto il catalogo

Per esplorare l’intero set di guide disponibili:

npx modern-web-guidance@latest list

4) Legacy scan: trovare punti del codebase da modernizzare

Questo è il comando più interessante quando lavori su progetti esistenti:

npx modern-web-guidance@latest legacy-scan

Lo scan:

  • analizza il repository,
  • individua pattern che potrebbero essere sostituiti da feature moderne,
  • spiega perché il cambiamento è utile e quando ha senso farlo,
  • ti indica quale guida consultare per applicare l’aggiornamento.

È un approccio pragmatico: non “riscrive tutto”, ma segnala dove il costo di manutenzione del legacy è alto e dove l’upgrade è sensato.

Baseline: decidere quanto “moderno” puoi permetterti

Il tema vero non è solo “usare feature nuove”, ma usarle quando sono ragionevolmente supportate.

Modern Web Guidance si appoggia al concetto di Baseline (lo stesso che molti riconoscono dai badge su MDN, tipo Widely available o Baseline 2026).

In configurazione puoi indicare il livello di compatibilità desiderato, ad esempio:

  • widely available (default): feature disponibili stabilmente in tutti i browser da un periodo significativo (circa 30 mesi);
  • una baseline per anno (es. baseline 2026) per essere più aggressivi.

Questa scelta influenza quali suggerimenti vengono considerati “accettabili” per il tuo progetto.

Modernizzare un progetto esistente: poco sforzo, resa alta

Un uso molto concreto è prendere un progetto funzionante ma pieno di workaround e chiedere una modernizzazione mirata.

Tipicamente i miglioramenti ricorrenti che emergono sono:

  • sostituire calcoli JS per dimensionamento con proprietà CSS dedicate (quando disponibili);
  • introdurre anchor positioning al posto di logiche manuali di posizionamento;
  • isolare fallback dentro @supports o caricamenti condizionali, così il codice “nuovo” resta pulito e quello “vecchio” si attiva solo se serve;
  • migliorare i modali perché blocchino correttamente lo scroll e rispettino la semantica nativa.

Il punto non è “scrivere meno codice” a tutti i costi, ma scrivere codice più stabile: meno eventi da ascoltare, meno stati impliciti, meno edge case da gestire a mano.

Sintesi: una cintura di sicurezza contro il codice datato

Modern Web Guidance è utile perché affronta un problema reale: l’AI non è automaticamente allineata allo stato attuale della piattaforma web, e tende a replicare pattern storici.

Con un’installazione rapida ottieni:

  • un set di guide moderne, operative e consultabili;
  • un’integrazione che spinge l’AI verso primitive native (dialog, popover, anchor positioning, ecc.);
  • strumenti CLI per cercare conoscenza “giusta” e per scovare aree legacy in un codebase;
  • un controllo esplicito sul compromesso modernità/compatibilità grazie a Baseline.

Implicazione pratica: se lavori su UI reali (modali, popup, form, tabelle interattive) e vuoi evitare di accumulare workaround generati automaticamente, questo tipo di guida è uno dei modi più diretti per trasformare output “ok” in output manutenibile, moderno e performante.