Vibe coding WordPress: come lavorare con un agente AI

01Cos'è il vibe coding con WordPress

Il vibe coding WordPress è un modo di costruire il sito descrivendo il risultato in linguaggio naturale a un agente AI, che scrive le modifiche al posto tuo. Non serve saper programmare per iniziare, ma serve saper riconoscere un risultato sbagliato.

Il vibe coding funziona bene per pagine, testi, sezioni e moduli. Diventa rischioso quando l'agente aggiunge codice, plugin o script che non controlli.

02Prepara l'ambiente prima di iniziare

Lavora su una copia del sito, non su quello che i visitatori usano. Un sito di staging o una copia locale bastano.

• Fai un backup completo del database e dei file.
• Crea un utente WordPress dedicato all'agente, con il ruolo minimo che serve.
• Annota le pagine che stai per cambiare e il loro stato attuale.
• Verifica che il sito di prova abbia la stessa versione di WordPress e di PHP del sito reale.

03Scrivi prompt che l'agente può eseguire

Un prompt vago produce una pagina vaga. Indica sempre quattro cose: lo scopo della pagina, le sezioni in ordine, i testi o la fonte dei testi, i vincoli.

• Scopo: chi legge la pagina e che cosa deve fare.
• Sezioni: titoli e ordine, con il numero massimo di elementi.
• Testi: scrivili tu o indica dove trovarli. Non chiedere di inventare numeri, clienti o recensioni.
• Vincoli: lingua, tono, nessun punto esclamativo, nessun codice personalizzato.

Crea una pagina di prova per un corso di cucina.
Sezioni: intro con titolo, tre vantaggi, domande frequenti, invito finale.
Lingua italiana, frasi brevi, nessun numero inventato.
Non aggiungere codice personalizzato né plugin.

04Controlla il risultato dopo ogni modifica

Non fidarti della prima versione. Controlla la pagina con questa lista prima di pubblicarla.

• Titolo SEO e descrizione: presenti, unici, di lunghezza corretta.
• Una sola intestazione h1 per pagina.
• Immagini con testo alternativo e peso contenuto.
• Moduli: invia un messaggio di prova e controlla la ricezione.
• Link e pulsanti: ogni link porta dove promette.
• Versione mobile: nessun testo tagliato, nessun elemento che si sovrappone.

05Rischi tipici del codice generato dall'AI

L'agente tende a risolvere un problema aggiungendo codice. Nella maggior parte dei casi conviene fermarlo e chiedere un modo che non tocchi il tema.

• Codice nel file functions.php del tema, che si perde al cambio di tema.
• Mu-plugin o script inseriti in wp_head, difficili da trovare e da togliere.
• Plugin nuovi non verificati, che ricevono accesso ai dati del sito.
• Permessi troppo ampi: l'agente può cambiare impostazioni che non servono al lavoro.

06Come lavora Nucleo con un agente AI

Nucleo descrive le pagine come documenti JSON. L'agente non scrive HTML libero: costruisce la pagina con i blocchi del catalogo, e Nucleo compila il risultato in HTML e CSS al salvataggio.

L'agente si collega a Nucleo tramite il server MCP con OAuth 2.1. Il consenso di un utente WordPress è sempre obbligatorio, e il token non può superare i permessi di quell'utente.

• Prima di scrivere, l'agente legge la guida a fasi con nucleo/guide, che non modifica nulla.
• Con dryRun, ogni scrittura mostra le differenze e il report di qualità senza salvare.
• Il report di qualità controlla SEO e accessibilità su ogni scrittura.
• Ogni salvataggio crea una revisione con l'autore, umano o AI. Con nucleo/doc-rollback torni a quella precedente.
• Il blocco nc/html, che accetta HTML libero, richiede una capacità esplicita.

07Sequenza di lavoro consigliata

Un ciclo sicuro ha quattro passi. Ripetilo per ogni pagina.

• Descrivi la pagina con un prompt, come nella sezione dei prompt.
• Chiedi all'agente una prova con dryRun e leggi il report.
• Apri l'anteprima firmata, valida 30 minuti, e controlla desktop e mobile.
• Pubblica solo quando il report non ha problemi bloccanti. Se un problema resta, registra il riconoscimento con una motivazione.