# Développement de blocs conçu pour l’IA

Des fichiers et aucune étape de compilation : exactement ce que les agents savent bien gérer.

[Lire la documentation](https://blockstudio.dev/fr/docs/dev/ai/)

Un enregistrement d’écran sans son : un agent de programmation crée un site WordPress complet avec 10 blocs personnalisés et 6 pages à partir d’une seule consigne.

## Décrivez un bloc, obtenez un bloc

Les agents de programmation IA peuvent créer la structure de blocs, de pages et de motifs à partir d’une seule consigne. Sans interface graphique ni base de données, uniquement des fichiers.

~/starter-theme

❯ Crée un bloc de tarification avec trois niveaux, un bouton mensuel/annuel et un appel à l’action pour chaque niveau.

✓ Créé le pricing/block.json

✓ Créé le pricing/index.php

✓ Créé le pricing/style.css

❯ Crée maintenant une page de tarifs avec une section d’accueil et une FAQ.

✓ Créé le pages/pricing/page.json

✓ Créé le pages/pricing/index.php

Fichiers

blockstudio/

├── pricing/ Nouveau

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Nouveau

├── page.json

└── index.php

## Tout est basé sur des fichiers

Les blocs, pages, motifs et extensions sont des répertoires contenant une configuration et des modèles JSON. Les agents peuvent les lire et les modifier directement.

## Aucune configuration de base de données

Aucun panneau d’administration à parcourir. Chaque paramètre est une clé JSON ; un agent peut donc préparer la bibliothèque sans navigateur.

## Structure prévisible

Chaque bloc suit la même convention : block.json, un modèle et des styles facultatifs. Apprenez le principe une fois.

## Du contexte, pas des suppositions

Un index compact de la documentation, ainsi que le texte intégral pour les outils qui en ont besoin.

### Un index que l’agent lit en premier

`blockstudio-llm.txt` répertorie une fois chaque document, avec son parcours, son fichier source, son objectif, ainsi que les paramètres, hooks, fonctions PHP et commandes CLI associés. Avec environ 11k jetons, un agent peut le lire en entier, puis ouvrir uniquement la page nécessaire.

`blockstudio-llm-full.txt` regroupe tous les documents et tous les schémas JSON dans un fichier d’environ 169k jetons, pour les outils qui ont besoin de tout le corpus. Activez `ai.enableContextGeneration` pour que votre site serve les deux.

[Documentation d’intégration de l’IA](https://blockstudio.dev/fr/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 contrat pour votre projet

La documentation décrit Blockstudio. AGENTS.md décrit le projet que l’agent s’apprête à modifier.

### Une commande génère AGENTS.md

`vendor/bin/blockstudio-agents` décrit le projet dans lequel il s’exécute : son contenu, les fonctionnalités activées par `blockstudio.json`, les motifs de rejet de l’analyse et les commandes applicables.

Chaque ligne provient de vos fichiers, paramètres ou du préréglage d’analyse sélectionné. La régénération conserve vos notes manuelles, et `--check` échoue si le contrat est obsolète.

[Contrat du projet](https://blockstudio.dev/fr/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.
```

## Erreurs détectées avant validation

Quatre préréglages d’analyse, chacun englobant le précédent, et un hook qui les exécute à chaque commit.

### Une analyse qui connaît block.json

Les préréglages `blockstudio/phpstan` analysent vos blocs, pages et paramètres. Si un modèle utilise un champ non déclaré par son `block.json` ou l’affiche sans échappement, l’analyse échoue.

Les modèles lisent un `$a` typé à partir du `block.json` situé à côté, avec un type PHP concret pour chaque type de champ, et `Db::get()` renvoie des enregistrements structurés selon `db.php`. Un chemin de réglage ou un nom de hook mal orthographié provoque une erreur, accompagnée d’une suggestion indiquant le nom réel le plus proche.

Définissez `githooks.commit` et exécutez `vendor/bin/blockstudio-githooks sync` : le hook de prévalidation géré lance la même analyse, empêchant tout bloc défectueux d’être validé.

[Préréglages d’analyse](https://blockstudio.dev/fr/docs/dev/phpstan/#analysis-presets)

blockstudio.json

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

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

Chaque clé $a utilisée par un modèle existe dans block.json ; les hooks, chemins de paramètres et balises de bloc sont réels.

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

En-têtes de thème, ressources déclarées, portée de %selector%, valeurs par défaut des champs et limites des répétiteurs.

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

PHPStan max, sortie échappée, aucune commande shell, classes Tailwind valides et JavaScript propres.

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

Thème Extreme et sonde de rendu WordPress en direct fournie par vos soins. Elle fonctionne sans shell ; tout échec du rendu est signalé.

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

Twig, Blade et les balises de bloc sont vérifiés à partir des mêmes champs. La couche Extreme analyse aussi JavaScript et les directives Interactivity en fonction de votre balisage et de vos magasins.

## [Projets existants](https://blockstudio.dev/fr/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

Une base PHPStan met de côté les problèmes déjà signalés, tandis que le nouveau code doit respecter l’intégralité du préréglage. blockstudioScanRoots détecte les bibliothèques de blocs situées hors de la racine, et les stubs fournis typent l’API publique.

## Inventaire et rendu depuis PHP

Quelques appels suffisent pour qu’un agent voie ce qu’un projet enregistre, en génère n’importe quelle partie et vérifie ce qu’il a stocké.

### Interrogez le projet, affichez la réponse

`Canvas::inventory()` renvoie chaque page, bloc, motif, modèle de l’éditeur de site, partie de modèle et exemple UI enregistré par un projet, sans rien afficher.

`Render::document()` affiche chacun d’eux sous forme de document HTML complet avec exactement les ressources utilisées ; un agent peut ainsi vérifier son travail hors de l’éditeur.

`Canvas::documents()` affiche exactement les enregistrements que vous sélectionnez. `Render::composition()` et `Render::content()` renvoient les déclarations imbriquées ou le contenu sérialisé des blocs sous forme de HTML, et `Ui::inventory()` ainsi que `Ui::examples()` répertorient les familles de composants intégrées avec une déclaration affichable chacune.

Pour un bloc, `bs_block_fields()`, `bs_block_extension_fields()`, `bs_block_values()` et `bs_block_assets()` renvoient ses champs, ses valeurs et ses assets sans l’afficher, et `bs_validate_block()` vérifie les attributs enregistrés avant leur sauvegarde.

[Rendu programmatique](https://blockstudio.dev/fr/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']);
```

## Moitié moins de jetons par page

Les agents écrivent du HTML simple. Blockstudio le transforme en balisage de blocs WordPress sérialisé lors de la synchronisation : moins à générer et moins de risques d’erreur.

### Blockstudio

Ce que les agents écrivent

Environ 135 jetons

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

Ce que le parseur écrit pour cela

Environ 310 jetons

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 -->
```

Mesure effectuée sur les deux panneaux ci-dessus : 540 caractères de HTML, contre 1,233 caractères de balisage de bloc écrits par le parseur standard, divisés par quatre, l’estimation habituelle du nombre de caractères par jeton. Le balisage est présenté avec des retours à la ligne pour en faciliter la lecture.

## Moins de contenu à générer

Les agents écrivent HTML sans délimiteurs de blocs, classes générées ni balisage d’encapsulation.

## Moins de risques d’erreur

L’analyseur garantit une sortie de bloc valide à partir de cette entrée simplifiée.

## Plus rapide et moins coûteux

Moins de jetons générés signifie des réponses plus rapides et des coûts de modèle réduits.

## Compatible avec tous les outils de codage IA

Tout agent capable de lire et d’écrire des fichiers fonctionne avec Blockstudio dès le départ.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## Conçu pour le flux de travail IA

Blocs, pages, motifs, paramètres : tout est un fichier qu’un agent peut lire, écrire et modifier.

## Deux fichiers par bloc

Une configuration JSON et un modèle constituent tout le bloc. Cette surface réduite rend la génération initiale fiable.

## 27 types de champs

Texte, fichiers, répétiteurs, couleurs, dates et plus, définis dans JSON. Les listes déroulantes sont alimentées par les publications, termes et utilisateurs.

## Validation du schéma JSON

Chaque configuration possède un schéma qui fournit des règles précises aux agents et détecte immédiatement les erreurs.

## Enregistrement automatique

Déposez des fichiers dans un répertoire : les blocs sont enregistrés automatiquement, sans liste de configuration supplémentaire.

## Vue d’ensemble du canevas

Toutes les pages gérées, ou tous les blocs avec leurs valeurs par défaut, dans une vue unique avec zoom.

## Canvas en direct

Le mode en direct actualise les plans de travail concernés via Server-Sent Events environ une seconde après l’enregistrement. Cliquez sur un libellé pour sélectionner un plan de travail.

## Intégré à Tailwind

TailwindPHP compile les classes utilisées par chaque page, sans configuration Node.

## Element Grabber

Copiez le chemin du modèle et le balisage d’un élément pour fournir instantanément du contexte à un agent.

## HTML vers les blocs

Les pages et motifs sont des fichiers simples qui deviennent des blocs WordPress natifs.

## Test rapide du rendu

wp bs blocks render affiche chaque bloc comme sur une page et renvoie le code de sortie 1 lorsqu’un modèle déclenche une notification, un avertissement ou une erreur.

## Vérifications du contenu enregistré

wp bs blocks validate vérifie les champs enregistrés des publications, et pages sync signale les attributs stockés par un bloc mais jamais affichés.

## Inspecter depuis le terminal

Répertoriez les réglages, les champs personnalisés et les assets avec wp bs, puis compilez un extrait ou un fichier avec wp bs tailwind compile ou wp bs scss compile.

Plus

## Le kit d’extension officiel

Modèles de site premium, instructions système pour l’IA et communauté privée Discord. Achat unique, mises à jour à vie.

- 500+ modèles de sites
- Instructions système de l’IA
- Mises à jour à vie
- Communauté privée Discord

[Obtenir Plus](https://blockstudio.dev/fr/plus/)
