Vai al contenuto

Sviluppo di blocchi nativo per l’IA

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

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.

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.

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.

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

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.

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