Vibecoding con Blockstudio
Andrej Karpathy ha coniato il termine “vibe coding” a febbraio 2025 per descrivere un flusso di lavoro in cui si spiega a un’IA cosa si vuole e questa scrive il codice. Un anno dopo, la pratica è maturata in quella che ora chiama “ingegneria agentica”: sviluppatori che orchestrano agenti IA invece di scrivere codice riga per riga.
Blockstudio è stato creato proprio per questo. L’architettura basata su file, l’assenza di strumenti di build e la struttura prevedibile dei progetti lo rendono uno dei migliori ambienti per lo sviluppo WordPress assistito dall’IA.
Questa guida illustra schemi pratici per usare agenti di programmazione IA con Blockstudio, dalla configurazione del progetto alla generazione di un sito completo.
Perché Blockstudio funziona bene con gli agenti IA
File, non database
Gli agenti di programmazione IA leggono e scrivono file. Questa è la loro interfaccia principale. Blockstudio conserva tutto nel filesystem: un block.json e un file template per ogni blocco, un page.json per ogni pagina, un pattern.json per ogni pattern. Non ci sono voci di database da gestire, schermate di amministrazione UI da esplorare né passaggi di build da eseguire.
Questo è importante perché i filesystem e i comandi della shell rappresentano una delle principali fonti dei dati di preaddestramento degli LLM. Ogni modello ha visto milioni di esempi di lettura, scrittura e organizzazione di file. Quando il flusso di lavoro di sviluppo WordPress segue questa stessa interfaccia, gli agenti possono lavorare con istruzioni minime.
Struttura prevedibile
Ogni blocco Blockstudio segue lo stesso schema:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Con questa coerenza, un agente che ha creato un blocco può crearne cento. Non ci sono sorprese, casi speciali o configurazioni nascoste. Lo stesso schema si applica alle pagine (page.json + template), ai pattern (pattern.json + template) e alle estensioni (extend.json).
Pagine complete come file
La creazione tradizionale di pagine WordPress richiede l’editor a blocchi: trascinare i blocchi, configurare le impostazioni e salvare dall’area di amministrazione. Gli agenti IA non possono fare nulla di tutto ciò. Hanno bisogno di file.
Le pagine basate su file di Blockstudio risolvono completamente il problema. Un page.json definisce i metadati della pagina, mentre un template index.php definisce la struttura dei blocchi usando HTML:
pages/about/
├── page.json # Title, slug, post type, template lock
└── index.php # Block structure as HTML
<block name="core/cover" key="hero" url="https://example.com/bg.jpg">
<h1 blockEditingMode="contentOnly">About Us</h1>
<p blockEditingMode="contentOnly">Our story.</p>
</block>
<div key="team">
<h2>The Team</h2>
<block name="my/team-member" />
<block name="my/team-member" />
</div>
Un agente può creare lo scheletro di un’intera pagina WordPress, completa di blocchi principali e personalizzati, blocco del template e controlli di modifica, scrivendo solo due file. Eseguite wp bs pages sync per applicare il sorgente a WordPress; l’apertura dell’area di amministrazione non esegue questa sincronizzazione automaticamente.
Questa è una delle funzionalità più potenti per lo sviluppo assistito dall’IA. Invece di descrivere il layout di una pagina e assemblarlo manualmente nell’editor, lo si descrive a un agente, che scrive il template. Il risultato è sotto controllo di versione, riproducibile e modificabile in pochi secondi.
Nessun passaggio di build
Non c’è nulla da compilare, assemblare o transpile. Un agente crea un file e questo funziona immediatamente. SCSS viene compilato lato server. I moduli ES vengono risolti in fase di esecuzione. Tailwind CSS viene compilato a ogni richiesta del frontend. Il ciclo di feedback tra “l’agente scrive codice” e “il codice viene eseguito nel browser” è il più breve possibile.
Perché Tailwind CSS è la scelta giusta
Blockstudio supporta sia CSS standard sia Tailwind CSS, ma Tailwind offre un vantaggio significativo quando si lavora con agenti IA.
Gli LLM conoscono molto bene Tailwind
Tailwind CSS è usato in decine di migliaia di repository open source. Alimenta le interfacce di Claude.ai, Vercel, Shopify, Cursor e dei prodotti di OpenAI stesso. Questa ampia presenza nei dati di addestramento consente agli LLM di generare classi Tailwind con grande precisione e di inventare raramente utility inesistenti.
Il vocabolario delle classi è finito e ben definito. Un agente non può inventare una proprietà CSS inesistente, riducendo notevolmente gli errori di stile rispetto a CSS libero, dove potrebbe generare selettori non validi o interpretare male il comportamento della cascata.
Gli stili sono nel markup
Con Tailwind, tutte le informazioni di stile sono raccolte nel template HTML. L’agente vede in un unico posto la descrizione visiva completa di un elemento. Non deve consultare separatamente i file .css, capire l’ordine della cascata o tenere traccia dei conflitti di specificità.
Questo è particolarmente utile per i blocchi Blockstudio, il cui template è già un singolo file. L’agente può generare in un unico passaggio un componente completo e stilizzato:
<div useBlockProps class="bg-white rounded-2xl shadow-lg p-8">
<h2 class="text-2xl font-bold text-gray-900">
<?php echo $a['title']; ?>
</h2>
<p class="mt-4 text-gray-600 leading-relaxed">
<?php echo $a['description']; ?>
</p>
</div>
Agenti paralleli senza conflitti
Poiché gli stili Tailwind sono circoscritti a ciascun template, più agenti (o sviluppatori) possono lavorare contemporaneamente su blocchi diversi senza CSS conflitti di merge. Non c’è un foglio di stile condiviso in cui le modifiche a un componente possano danneggiarne accidentalmente un altro. Ogni blocco è autonomo.
Questo funziona bene anche con CSS standard, usando gli stili circoscritti di Blockstudio (style.scoped.css), ma Tailwind elimina del tutto il file CSS, riducendo di un file per blocco ciò che l’agente deve gestire.
Anche CSS standard funziona
Tailwind non è necessario. La pipeline degli asset di Blockstudio gestisce automaticamente i file .css e .scss, compresi gli stili circoscritti con namespace specifici per il blocco. Se il progetto usa una metodologia CSS diversa, anche gli agenti possono lavorare con quella. Il vantaggio di Tailwind è semplicemente che gli LLM lo gestiscono meglio grazie alla presenza nei dati di addestramento e alla vicinanza degli stili al markup.
Agenti di programmazione IA
I seguenti strumenti CLI possono lavorare con i progetti Blockstudio senza configurazioni aggiuntive. Leggono e scrivono file, eseguono comandi shell e comprendono la struttura del progetto grazie ai file di contesto.
Agenti da terminale (CLI)
| Strumento | Fornitore | Note |
|---|---|---|
| Claude Code | Anthropic | Agente pensato per il terminale. Legge CLAUDE.md per ricavare il contesto del progetto. |
| Codex CLI | OpenAI | CLI open source, realizzato in Rust. Disponibile anche come app desktop. |
| Gemini CLI | Open source, con una finestra di contesto da 1M token. Legge GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Agenti paralleli specializzati per esplorazione, attività, pianificazione e revisione. |
| Aider | Open source | Supporta 100+ provider LLM, inclusi i modelli locali. |
| OpenCode | Open source | TUI da terminale con integrazione LSP. Supporta oltre 75 provider. |
| Amazon Q Developer CLI | AWS | Disponibile un piano gratuito. Ideale per progetti integrati con AWS. |
Agenti IDE
| Strumento | Fornitore | Note |
|---|---|---|
| Cursor | Cursor | Fork di VS Code con IA integrata. Disponibile anche una CLI (beta). |
| Windsurf | Cognition AI | Fork di VS Code con assistente agentico Cascade. |
| Cline | Open source | Estensione VS Code con approvazione passo per passo. Disponibile anche una CLI. |
| Kilo Code | Open source | Modalità orchestratore con sottoagenti coordinati. |
| Continue | Open source | Estensione VS Code/JetBrains con agenti CI/CD asincroni. |
| Augment Code | Augment | Pensato per le aziende, con indicizzazione approfondita del codice. |
Tutti questi strumenti possono creare e modificare file in una directory di progetto Blockstudio. Gli agenti da terminale sono particolarmente adatti perché lo sviluppo Blockstudio non richiede funzionalità specifiche dell’IDE: si basa interamente sui file.
Configurare il progetto per gli agenti IA
Il file di contesto per gli LLM
Blockstudio include un file di contesto precompilato che indicizza tutta la documentazione del framework. Non è un riepilogo né un promemoria: ogni documento è elencato una volta con il relativo percorso, lo scopo e gli identificatori di cui è responsabile, così un agente può trovare la pagina che risponde a una domanda e aprire solo quella. Il testo completo di ogni documento e schema è disponibile in un secondo file per gli strumenti che vogliono consultare l’intero corpus in una volta.
Abilitatelo nel vostro blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
L’indice è ora disponibile su your-site.com/blockstudio-llm.txt e il testo completo su your-site.com/blockstudio-llm-full.txt. Indicate al vostro strumento AI l’indice e potrà accedere all’intero Blockstudio API senza ulteriori istruzioni. Consultate la documentazione sull’integrazione AI per la configurazione specifica di ogni strumento.
Così non dovrete scrivere da soli istruzioni specifiche per il framework. Un agente che può accedere a blockstudio-llm.txt può trovare come creare blocchi, definire campi, scrivere template, configurare Tailwind, impostare pagine e usare tutti gli hook forniti da Blockstudio.
File di contesto specifici del progetto
La maggior parte degli agenti di programmazione IA legge anche un file di contesto a livello di progetto con istruzioni specifiche per il vostro codice. Le convenzioni variano a seconda dello strumento:
| File | Strumento |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI e altri |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Dato che blockstudio-llm.txt copre già il framework, il file di contesto del progetto deve descrivere solo ciò che è specifico del vostro progetto: struttura delle directory, convenzioni di denominazione, comandi e limiti.
Se installate blockstudio/phpstan, non dovrete scrivere quella descrizione a mano. vendor/bin/blockstudio-agents genera un AGENTS.md dai vostri blockstudio.json e dai vostri file, indicando cosa fa il progetto, quali funzionalità sono abilitate, quali analisi verranno rifiutate e quali comandi sono applicabili. Si rifiuta di sovrascrivere un file che non ha creato e conserva le vostre note quando lo rigenerate.
# My WordPress Site
Built with Blockstudio 7. File-based blocks with Tailwind CSS.
Fetch https://example.com/blockstudio-llm.txt for full framework docs.
## Structure
- `blockstudio/` - Custom blocks (block.json + index.php)
- `pages/` - File-based pages (page.json + index.php)
- `patterns/` - Block patterns (pattern.json + index.php)
- `blockstudio.json` - Plugin settings
## Conventions
- Use Tailwind utility classes for all styling
- Keep blocks small and focused: one component per block
- Use `$a['fieldId']` to access field values in templates
## Commands
- `wp server` - Start local development server
Strumenti per sviluppatori nei flussi di lavoro con l’IA
Blockstudio include due strumenti per sviluppatori progettati appositamente per lo sviluppo assistito dall’IA.
Canvas
La tela offre una panoramica simile a Figma di tutte le vostre pagine Blockstudio, visualizzate come tavole iframe interattive in un’unica schermata. Spostatevi con il trackpad e ingrandite o riducete con il gesto di avvicinamento delle dita o Ctrl+scorrimento.
È utile quando lavorate con agenti IA perché offre una panoramica visiva di ogni pagina senza cambiare scheda o navigare nell’area di amministrazione WordPress. Quando un agente modifica il template di una pagina, potete vedere subito il risultato. Attivate la modalità live e il canvas si aggiornerà automaticamente quando cambiano i file.
Abilitatelo in blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Poi visitate /wp-admin/admin.php?page=blockstudio-canvas. Passate dalla visualizzazione delle pagine (tavole da disegno a tutta larghezza) a quella dei blocchi (griglia con tutti i blocchi registrati e i valori predefiniti).
Element Grabber
Il selettore di elementi risolve un problema comune nei flussi di lavoro con l’AI: indicare all’agente quale file visualizza un elemento specifico della pagina.
Aggiungete ?blockstudio-devtools a qualsiasi URL frontend, quindi tenete premuto Cmd+C (Mac) o Ctrl+C (Windows) per 100ms. Si attiva un selettore a mirino che evidenzia i blocchi Blockstudio al passaggio del cursore. Fate clic su un elemento per copiarne il contesto negli appunti:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Incollatelo nel vostro strumento di programmazione IA e l’agente saprà subito il percorso del file, la struttura HTML e l’elemento che state indicando. Non dovrete più cercare manualmente i percorsi dei file template.
Abilitatelo in blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Schemi pratici
Creare un singolo blocco
Il flusso di lavoro più semplice: descrivete ciò che volete e lasciate che l’agente lo crei.
Prompt:
Crea un blocco per testimonianze con campi per la citazione (area di testo), il nome dell’autore (testo), il ruolo dell’autore (testo) e la foto dell’autore (file). Usa Tailwind per gli stili. La citazione deve avere un carattere grande e corsivo, con un segno di citazione decorativo.
L’agente creerà:
blockstudio/testimonial/
├── block.json
└── index.php
Creare una pagina completa
Le pagine basate su file di Blockstudio consentono a un agente di creare un’intera pagina WordPress come template. È qui che si vede il vero vantaggio: invece di creare i blocchi uno alla volta, l’agente genera in un’unica operazione la struttura completa della pagina con tutti i suoi blocchi.
Prompt:
Crea una pagina “Chi siamo” con una sezione introduttiva, una griglia del team e un modulo di contatto segnaposto. Usa i blocchi esistenti dove possibile e creane di nuovi quando necessario. Associala all’ID post 2. Blocca il template, ma consenti di modificare i titoli e i paragrafi.
L’agente crea:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Oltre a tutti i blocchi personalizzati a cui fa riferimento (e.g, blockstudio/team-member/). Eseguite
wp bs pages sync per creare il post WordPress con il blocco del template e i
controlli di modifica. L’intera pagina è sotto controllo di versione e riproducibile.
Creare un sito completo
È qui che l’architettura di Blockstudio dà il meglio di sé. Un singolo prompt può generare un intero sito, perché ogni elemento è un file:
Prompt:
Crea un sito portfolio con queste pagine: Home, Lavori, Chi siamo, Contatti. Crea blocchi personalizzati per: sezione introduttiva, griglia dei progetti, scheda del progetto, membro del team, informazioni di contatto e piè di pagina. Usa un tema scuro con Tailwind. Configura Tailwind in blockstudio.json con una tavolozza di colori personalizzata.
L’agente crea le directory dei blocchi, i template delle pagine, un blockstudio.json con la configurazione Tailwind e, facoltativamente, pattern per sezioni riutilizzabili. Tutto viene registrato in git come un’unica serie di modifiche.
Flussi di lavoro con agenti paralleli
Alcuni strumenti (l’app desktop di Codex, GitHub Copilot CLI, Kilo Code) supportano l’esecuzione parallela di più agenti. L’architettura di Blockstudio, con un file per blocco, rende sicuro questo approccio:
- Agente 1: crea il blocco introduttivo e la pagina Home
- Agente 2: crea il blocco della scheda progetto e la pagina Lavori
- Agente 3: crea il blocco del modulo di contatto e la pagina Contatti
Poiché ogni blocco si trova nella propria directory e gli stili Tailwind sono raccolti nei template, gli agenti non entreranno in conflitto. L’unico file condiviso è blockstudio.json, che in genere va configurato una sola volta all’inizio.
Suggerimenti per risultati migliori
-
Fate riferimento al file di contesto degli LLM. Gli agenti producono codice Blockstudio decisamente migliore quando possono consultare la documentazione del framework. Indicate sempre
blockstudio-llm.txte fornite unAGENTS.mdgenerato per il progetto stesso. -
Specificate i tipi di campo. Invece di dire "aggiungi un campo immagine", dite "aggiungi un campo file con
allowedTypes: ['image']ereturnFormat: 'object'." Più precise sono le definizioni dei campi, meno iterazioni serviranno. -
Iniziate con un blocco e poi aumentate la scala. Fate creare correttamente un blocco all’agente, esaminatene gli schemi e poi chiedetegli di creare gli altri seguendo le stesse convenzioni. In questo modo stabilite un riferimento che migliora i risultati successivi.
-
Esaminate il risultato. Il vibe coding non significa accettare il codice senza controllarlo. Verificate che i tipi di campo corrispondano alle vostre intenzioni, che i template vengano visualizzati correttamente e che le classi Tailwind producano il risultato visivo desiderato. Il codice generato dall’IA va esaminato prima della pubblicazione.
-
Usate gli schemi
block.json. Blockstudio fornisce uno schema JSON all’indirizzohttps://blockstudio.dev/schema/block. Aggiungere"$schema"al vostro block.json fornisce agli agenti riscontri di convalida e previene configurazioni non valide. -
Mantenete i blocchi piccoli e mirati. Un blocco per componente visivo. Così ogni blocco è più semplice da elaborare per l’agente e i template restano abbastanza brevi da rientrare in un singolo passaggio della finestra di contesto.