# Sviluppo di blocchi nativo per l’IA

File e nessuna fase di build: ciò che gli agenti sanno fare bene.

[Leggi la documentazione](https://blockstudio.dev/it/docs/dev/ai/)

Una registrazione dello schermo senza audio: un agente di programmazione crea un sito WordPress completo con 10 blocchi personalizzati e 6 pagine partendo da un singolo prompt.

## Descrivi un blocco, ottieni un blocco

Gli agenti di programmazione AI possono creare lo scheletro di blocchi, pagine e pattern partendo da un solo prompt. Nessuna interfaccia grafica né database: solo file.

~/starter-theme

❯ Crea un blocco prezzi con tre livelli, un selettore mensile/annuale e un invito all’azione per ciascun livello.

✓ Data di creazione pricing/block.json

✓ Data di creazione pricing/index.php

✓ Data di creazione pricing/style.css

❯ Ora crea una pagina dei prezzi con un hero e una sezione FAQ.

✓ Data di creazione pages/pricing/page.json

✓ Data di creazione pages/pricing/index.php

File

blockstudio/

├── pricing/ Nuovo

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Nuovo

├── page.json

└── index.php

## Tutto basato su file

Blocchi, pagine, pattern ed estensioni sono directory con configurazione e template JSON. Gli agenti li leggono e modificano in modo nativo.

## Configurazione senza database

Nessun pannello di amministrazione da navigare. Ogni impostazione è una chiave JSON, così un agente può creare la libreria senza browser.

## Struttura prevedibile

Ogni blocco segue la stessa convenzione: block.json, un template e stili facoltativi. Impara il modello una volta sola.

## Contesto, senza supposizioni

Un indice compatto della documentazione, con il testo completo per gli strumenti che lo vogliono tutto.

### Un indice che l’agente legge per primo

`blockstudio-llm.txt` elenca una volta ogni documento, con route, file sorgente, scopo, impostazioni, hook, funzioni PHP e comandi CLI associati. Con circa 11k token, un agente lo legge tutto e poi apre solo la pagina necessaria.

`blockstudio-llm-full.txt` include in un file tutti i documenti e tutti gli schemi JSON, circa 169k token, per gli strumenti che vogliono l’intero corpus. Attiva `ai.enableContextGeneration` e il tuo sito li serve entrambi.

[Documentazione per l’integrazione con l’IA](https://blockstudio.dev/it/docs/dev/ai/)

blockstudio-llm.txt

```
# Blockstudio documentation index

This is the primary context file for coding assistants. It is an index, not
the documentation itself. Each entry names one document, what it is for, and
the identifiers that document owns. Read this index, then open only the
document you need.

Every document is addressable two ways: as a URL on https://blockstudio.dev,
and as a Markdown file in the Blockstudio repository. The full text of every
document and schema is also available in one file at /blockstudio-llm-full.txt
for tools that want everything at once.
```

## Un contratto per il tuo progetto

La documentazione descrive Blockstudio. AGENTS.md descrive il progetto che l’agente sta per modificare.

### Un comando genera AGENTS.md

`vendor/bin/blockstudio-agents` descrive il progetto in cui viene eseguito: cosa contiene, quali funzionalità abilita `blockstudio.json`, cosa verrà rifiutato dall’analisi e quali comandi sono applicabili.

Ogni riga proviene dai tuoi file, dalle tue impostazioni o dal preset di analisi selezionato. La rigenerazione conserva le note scritte a mano e `--check` fallisce se il contratto non è aggiornato.

[Contratto del progetto](https://blockstudio.dev/it/docs/dev/phpstan/#project-contract-for-coding-agents)

AGENTS.md

```
# Blockstudio contract for Acme

## Project

- Kind: WordPress theme `Acme`.
- Configuration: `blockstudio.json`.
- Analysis preset: `extreme-theme`.

## What this project contains

- Blocks: 1 in `blockstudio`.
- Pages: 1 in `pages`.
- Block namespaces: `acme`.
- Block templates are written in PHP.
```

## Errori rilevati prima del commit

Quattro preset di analisi, ciascuno estensione del precedente, e un hook che li esegue a ogni commit.

### Analisi consapevole di block.json

I preset `blockstudio/phpstan` analizzano blocchi, pagine e impostazioni. L’analisi fallisce se un template legge un campo non dichiarato dal suo `block.json` o lo stampa senza escape.

I template leggono un `$a` tipizzato dal `block.json` accanto a essi, con un tipo PHP concreto per ogni tipo di campo, mentre `Db::get()` restituisce record strutturati secondo `db.php`. Un percorso di impostazioni o un nome di hook scritto in modo errato genera un errore con il suggerimento del nome reale più simile.

Configura `githooks.commit` ed esegui `vendor/bin/blockstudio-githooks sync`: l’hook pre-commit gestito esegue la stessa analisi, così un blocco difettoso non arriva al commit.

[Preset di analisi](https://blockstudio.dev/it/docs/dev/phpstan/#analysis-presets)

blockstudio.json

```
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "phpstan": { "preset": "extreme-theme" },
  "githooks": { "commit": true }
}
```

## [base](https://blockstudio.dev/it/docs/dev/phpstan/#analysis-presets)

Ogni chiave $a letta da un template esiste in block.json; hook, percorsi delle impostazioni e tag dei blocchi sono reali.

## [theme](https://blockstudio.dev/it/docs/dev/phpstan/#analysis-presets)

Intestazioni dei temi, risorse dichiarate, ambito %selector%, valori predefiniti dei campi e limiti dei ripetitori.

## [extreme-theme](https://blockstudio.dev/it/docs/dev/phpstan/#analysis-presets)

Limite massimo PHPStan, output con escape, nessuna esecuzione di comandi shell, classi Tailwind valide e JavaScript pulito.

## [wordpress-render](https://blockstudio.dev/it/docs/dev/phpstan/#live-wordpress-rendering)

Tema Extreme e una sonda di rendering WordPress attiva fornita da voi. Funziona senza shell e un rendering non riuscito genera una segnalazione.

## [Twig, Blade e script](https://blockstudio.dev/it/docs/dev/phpstan/#what-it-checks)

Twig, Blade e i tag dei blocchi vengono verificati rispetto agli stessi campi. Il livello Extreme legge anche JavaScript e le direttive Interactivity e le confronta con il markup e gli store.

## [Progetti esistenti](https://blockstudio.dev/it/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

Una baseline PHPStan tiene da parte le segnalazioni registrate, mentre il nuovo codice deve rispettare il preset completo. blockstudioScanRoots legge le librerie di blocchi esterne alla radice e gli stub inclusi definiscono i tipi dell’API pubblica API.

## Inventario e rendering da PHP

Bastano poche chiamate perché un agente possa vedere cosa registra un progetto, eseguirne il rendering in ogni sua parte e controllare cosa ha salvato.

### Interroga il progetto, visualizza la risposta

`Canvas::inventory()` restituisce ogni pagina, blocco, pattern, template dell’Editor del sito, parte di template ed esempio UI registrato nel progetto, senza eseguire il rendering.

`Render::document()` esegue il rendering di ciascuno come documento HTML completo, con esattamente le risorse utilizzate, così un agente può verificare il lavoro fuori dall’editor.

`Canvas::documents()` renderizza esattamente i record selezionati. `Render::composition()` e `Render::content()` restituiscono dichiarazioni annidate o contenuti di blocchi serializzati come HTML, mentre `Ui::inventory()` e `Ui::examples()` elencano le famiglie di componenti incluse, ciascuna con una dichiarazione renderizzabile.

Per un singolo blocco, `bs_block_fields()`, `bs_block_extension_fields()`, `bs_block_values()` e `bs_block_assets()` restituiscono i suoi campi, valori e asset senza renderizzarlo, mentre `bs_validate_block()` controlla gli attributi salvati prima che li salviate.

[Rendering programmatico](https://blockstudio.dev/it/docs/blocks/rendering/#structured-compositions-and-complete-documents)

inspect.php

```
use Blockstudio\Canvas;
use Blockstudio\Render;

$project = Canvas::inventory(['blocks' => true]);

foreach ($project['inventory']['blocks'] as $block) {
  echo $block['name'] . "\n";
}

$doc = Render::document(
  ['name' => 'acme/hero', 'data' => ['heading' => 'Hello']],
  ['title' => 'Hero preview']
);

file_put_contents('hero.html', $doc['html']);
```

## Meno della metà dei token per pagina

Gli agenti scrivono semplice HTML. Blockstudio lo converte in markup a blocchi WordPress serializzato durante la sincronizzazione: meno da generare e meno errori.

### Blockstudio

Cosa scrivono gli agenti

Circa 135 token

index.php

```
<h1>Build Websites That Convert</h1>
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>

<block name="core/columns">
  <block name="core/column">
    <h3>Lightning Fast</h3>
    <p>Pages load in under one second.</p>
  </block>
  <block name="core/column">
    <h3>Easy to Use</h3>
    <p>No technical skills required.</p>
  </block>
  <block name="core/column">
    <h3>SEO Optimized</h3>
    <p>Built-in best practices from day one.</p>
  </block>
</block>

<img src="/dashboard.jpg" alt="Dashboard" />
```

### WordPress

Cosa scrive il parser per questo

Circa 310 token

post_content

```
<!-- wp:heading {"level":1} -->
<h1 class="wp-block-heading">Build Websites That Convert</h1>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>
<!-- /wp:paragraph -->
<!-- wp:columns -->
<div class="wp-block-columns">
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Lightning Fast</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Pages load in under one second.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Easy to Use</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>No technical skills required.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">SEO Optimized</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Built-in best practices from day one.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
</div>
<!-- /wp:columns -->
<!-- wp:image {"alt":"Dashboard","url":"/dashboard.jpg"} -->
<figure class="wp-block-image"><img src="/dashboard.jpg" alt="Dashboard"/></figure>
<!-- /wp:image -->
```

Misurato sui due pannelli qui sopra: 540 caratteri di HTML rispetto ai 1,233 caratteri del markup del blocco che il parser standard scrive per questo, divisi per quattro, la stima usuale dei caratteri per token. Il markup è mostrato con interruzioni di riga aggiunte per facilitarne la lettura.

## Meno output da generare

Gli agenti scrivono HTML senza delimitatori dei blocchi, classi generate o markup contenitore.

## Meno possibilità di errore

Il parser garantisce un output valido per i blocchi a partire da un input più semplice.

## Più rapido ed economico

Meno token di output significa risposte più rapide e costi inferiori per i modelli.

## Funziona con ogni strumento di programmazione IA

Qualsiasi agente in grado di leggere e scrivere file funziona con Blockstudio fin da subito.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## Progettato per il flusso di lavoro con l’IA

Blocchi, pagine, pattern, impostazioni. Tutto è un file che un agente può leggere, scrivere e modificare.

## Due file per blocco

Una configurazione JSON e un template costituiscono l’intero blocco. La superficie ridotta rende affidabile la generazione al primo tentativo.

## 27 tipi di campo

Testo, file, ripetitori, colori, date e altro, definiti in JSON. Le opzioni si popolano da articoli, termini e utenti.

## Validazione dello schema JSON

Ogni configurazione ha uno schema, che fornisce agli agenti regole precise e rileva subito gli errori.

## Registrazione automatica

Aggiungi i file a una directory e i blocchi vengono registrati automaticamente, senza un altro elenco di configurazione.

## Panoramica su canvas

Ogni pagina gestita oppure ogni blocco con i suoi valori predefiniti, in un’unica vista zoomabile.

## Canvas live

La modalità live aggiorna le tavole da disegno interessate tramite Server-Sent Events circa un secondo dopo il salvataggio. Fate clic su un’etichetta per mettere a fuoco una tavola.

## Tailwind integrato

TailwindPHP compila le classi usate da ogni pagina, senza configurare Node.

## Element Grabber

Copia il percorso del template e il markup di un elemento per fornire subito contesto a un agente.

## HTML nei blocchi

Pagine e pattern sono semplici file che diventano blocchi nativi WordPress.

## Test rapido di rendering

wp bs blocks render renderizza ogni blocco come farebbe una pagina e termina con 1 se un template genera una notifica, un avviso o un errore.

## Controlli sui contenuti salvati

wp bs blocks validate controlla i campi salvati dei post e delle pagine; sync segnala gli attributi che un blocco salva ma non renderizza mai.

## Esaminate dal terminale

Elencate impostazioni, campi personalizzati e asset con wp bs, e compilate uno snippet o un file con wp bs tailwind compile o wp bs scss compile.

Plus

## Il kit ufficiale di estensioni

Template di siti premium, istruzioni di sistema per l’AI e una community privata Discord. Acquisto una tantum, aggiornamenti a vita.

- Oltre 500 modelli di siti
- Istruzioni di sistema per l’AI
- Aggiornamenti a vita
- Community privata di Discord

[Passa a Plus](https://blockstudio.dev/it/plus/)
