Coder au feeling avec Blockstudio
Andrej Karpathy a inventé le terme « vibe coding » en février 2025 pour décrire une méthode de travail où l’on explique à une IA ce que l’on veut et où elle écrit le code. Un an plus tard, cette pratique a mûri pour devenir ce qu’il appelle désormais « ingénierie agentique » : les développeurs orchestrent des agents IA au lieu d’écrire le code ligne par ligne.
Blockstudio a été conçu pour cela. Son architecture fondée sur des fichiers, l’absence d’outils de compilation et la structure prévisible des projets en font l’un des meilleurs environnements pour le développement WordPress assisté par l’IA.
Ce guide présente des méthodes pratiques pour utiliser des agents de programmation IA avec Blockstudio, de la configuration du projet à la génération complète d’un site.
Pourquoi Blockstudio fonctionne bien avec les agents IA
Des fichiers, pas des bases de données
Les agents de programmation IA lisent et écrivent des fichiers. C’est leur interface principale. Blockstudio conserve tout dans le système de fichiers : un block.json et un fichier de modèle par bloc, un page.json par page, un pattern.json par composition. Pas d’entrées de base de données à gérer, pas d’UI d’administration à parcourir, pas d’étape de compilation à lancer.
C’est important, car les systèmes de fichiers et les commandes shell constituent l’une des principales sources de données de préentraînement des LLM. Tous les modèles ont vu des millions d’exemples de lecture, d’écriture et d’organisation de fichiers. Lorsque votre flux de développement WordPress correspond à cette interface, les agents peuvent travailler avec un minimum d’instructions.
Une structure prévisible
Chaque bloc Blockstudio suit le même modèle :
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Grâce à cette cohérence, un agent qui a créé un bloc peut en créer cent. Pas de surprise, de cas particulier ni de configuration cachée. Le même modèle s’applique aux pages (page.json + modèle), aux compositions (pattern.json + modèle) et aux extensions (extend.json).
Des pages complètes sous forme de fichiers
La création traditionnelle de pages WordPress nécessite l’éditeur de blocs : déplacer des blocs, configurer des réglages, enregistrer depuis l’administration. Les agents IA ne peuvent rien faire de tout cela. Ils ont besoin de fichiers.
Les pages fondées sur des fichiers de Blockstudio résolvent entièrement ce problème. Un page.json définit les métadonnées de la page, et un modèle index.php définit la structure des blocs à l’aide de 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 agent peut créer l’ébauche d’une page WordPress complète, avec des blocs natifs et personnalisés, le verrouillage du modèle et les commandes d’édition, en écrivant simplement deux fichiers. Exécutez wp bs pages sync pour appliquer la source à WordPress ; l’ouverture de l’administration ne lance jamais cette synchronisation implicitement.
C’est l’une des fonctionnalités les plus puissantes pour le développement assisté par l’IA. Au lieu de décrire la mise en page et de l’assembler manuellement dans l’éditeur, vous la décrivez à un agent, qui écrit le modèle. Le résultat est suivi dans le contrôle de version, reproductible et modifiable en quelques secondes.
Aucune étape de compilation
Il n’y a rien à compiler, à regrouper ni à transpiler. Un agent crée un fichier, qui fonctionne immédiatement. SCSS est compilé côté serveur. Les modules ES sont résolus à l’exécution. Tailwind CSS est compilé à chaque requête du frontend. Le cycle entre « l’agent écrit du code » et « le code s’exécute dans le navigateur » est aussi court que possible.
Pourquoi choisir Tailwind CSS
Blockstudio prend en charge à la fois CSS classique et Tailwind CSS, mais Tailwind offre un avantage considérable avec les agents IA.
Les LLM connaissent très bien Tailwind
Tailwind CSS est utilisé dans des dizaines de milliers de dépôts open source. Il alimente les interfaces de Claude.ai, Vercel, Shopify, Cursor et des propres produits de OpenAI. Cette présence dans les données d’entraînement permet aux LLM de générer des classes Tailwind avec précision et d’inventer rarement des utilitaires inexistants.
Le vocabulaire des classes est fini et bien défini. Un agent ne peut pas inventer une propriété CSS inexistante, ce qui réduit considérablement les erreurs de style par rapport au CSS libre, où l’agent pourrait générer des sélecteurs invalides ou mal interpréter le comportement de la cascade.
Les styles sont dans le balisage
Avec Tailwind, toutes les informations de style se trouvent dans le même HTML de modèle. L’agent voit la description visuelle complète d’un élément au même endroit. Inutile de consulter séparément les fichiers .css, de comprendre l’ordre de la cascade ou de suivre les conflits de spécificité.
C’est particulièrement utile pour les blocs Blockstudio, dont le modèle tient déjà dans un seul fichier. L’agent peut générer un composant complet et stylisé en une seule fois :
<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>
Des agents en parallèle sans conflits
Comme les styles Tailwind sont limités à chaque modèle, plusieurs agents (ou développeurs) peuvent travailler simultanément sur des blocs différents sans conflits de fusion CSS. Il n’y a pas de feuille de style commune dont les modifications pour un composant risqueraient de casser un autre. Chaque bloc est autonome.
Cela fonctionne aussi bien avec CSS classique et les styles délimités de Blockstudio (style.scoped.css), mais Tailwind élimine entièrement le fichier CSS, soit un fichier de moins à gérer par bloc pour l’agent.
CSS classique reste compatible
Tailwind n’est pas obligatoire. Le pipeline de ressources de Blockstudio gère automatiquement les fichiers .css et .scss, y compris les styles délimités et préfixés pour chaque bloc. Si votre projet utilise une autre méthode CSS, les agents peuvent aussi s’en servir. L’avantage de Tailwind tient simplement au fait que les LLM le maîtrisent mieux grâce à sa présence dans les données d’entraînement et à la proximité des styles et du balisage.
Agents de programmation IA
Les outils CLI suivants fonctionnent tous avec les projets Blockstudio dès leur installation. Ils lisent et écrivent des fichiers, exécutent des commandes shell et comprennent la structure du projet à partir des fichiers de contexte.
Agents de terminal (CLI)
| Outil | Fournisseur | Remarques |
|---|---|---|
| Claude Code | Anthropic | Agent pensé pour le terminal. Lit CLAUDE.md pour comprendre le projet. |
| Codex CLI | OpenAI | CLI open source, écrit en Rust. Aussi disponible en application de bureau. |
| Gemini CLI | Open source, avec une fenêtre de contexte d’un million de jetons. Lit GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Agents parallèles spécialisés pour l’exploration, les tâches, la planification et la révision. |
| Aider | Open source | Prend en charge plus de 100 fournisseurs de LLM, modèles locaux compris. |
| OpenCode | Open source | Interface terminal TUI avec intégration LSP. Prend en charge plus de 75 fournisseurs. |
| Amazon Q Developer CLI | AWS | Offre une formule gratuite. Efficace pour les projets intégrés à AWS. |
Agents pour IDE
| Outil | Fournisseur | Remarques |
|---|---|---|
| Cursor | Cursor | Fork de VS Code avec IA intégrée. Propose aussi une CLI (bêta). |
| Windsurf | Cognition AI | Fork de VS Code avec l’assistant agentique Cascade. |
| Cline | Open source | Extension VS Code avec approbation étape par étape. Propose aussi une CLI. |
| Kilo Code | Open source | Mode orchestrateur avec sous-agents coordonnés. |
| Continue | Open source | Extension VS Code/JetBrains avec agents CI/CD asynchrones. |
| Augment Code | Augment | Conçu pour les entreprises, avec indexation approfondie du code. |
Tous ces outils peuvent créer et modifier des fichiers dans le répertoire d’un projet Blockstudio. Les agents de terminal sont particulièrement adaptés, car le développement Blockstudio ne nécessite aucune fonctionnalité propre à un IDE : il repose entièrement sur des fichiers.
Préparer votre projet pour les agents IA
Le fichier de contexte du LLM
Blockstudio fournit un fichier de contexte préconstruit qui indexe toute la documentation du framework. Ce n’est ni un résumé ni un aide-mémoire : chaque document figure une seule fois, avec son chemin, son objectif et les identifiants qui lui sont associés. L’agent peut ainsi trouver la page qui répond à une question et ne consulter que celle-ci. Le texte intégral de chaque document et schéma reste disponible dans un second fichier pour les outils qui veulent accéder à tout le corpus d’un coup.
Activez-le dans votre blockstudio.json :
{
"ai": {
"enableContextGeneration": true
}
}
L’index est maintenant disponible dans your-site.com/blockstudio-llm.txt, et le texte intégral dans your-site.com/blockstudio-llm-full.txt. Indiquez l’index à votre outil IA pour qu’il puisse accéder à l’ensemble de la Blockstudio API sans instruction supplémentaire. Consultez la documentation sur l’intégration IA pour configurer chaque outil.
Cela vous évite de rédiger vous-même des instructions propres au framework. Un agent qui a accès à blockstudio-llm.txt peut trouver comment créer des blocs, définir des champs, écrire des modèles, configurer Tailwind, préparer des pages et utiliser tous les hooks fournis par Blockstudio.
Fichiers de contexte propres au projet
La plupart des agents de programmation IA lisent aussi un fichier de contexte à l’échelle du projet, qui contient des instructions propres à votre codebase. La convention varie selon l’outil :
| Fichier | Outil |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI, et autres |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Comme blockstudio-llm.txt couvre déjà le framework, le fichier de contexte de votre projet n’a besoin de décrire que ce qui lui est propre : l’organisation des répertoires, les conventions de nommage, les commandes et les limites.
Si vous installez blockstudio/phpstan, vous n’avez pas à rédiger cette description à la main. vendor/bin/blockstudio-agents génère un AGENTS.md à partir de votre blockstudio.json et de vos propres fichiers. Il indique ce que le projet produit, les fonctionnalités activées, les éléments que l’analyse rejettera et les commandes disponibles. Il refuse d’écraser un fichier qu’il n’a pas créé et conserve vos propres notes lorsque vous le régénérez.
# 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
Outils de développement pour les flux de travail IA
Blockstudio comprend deux outils de développement conçus spécialement pour le développement assisté par l’IA.
Canvas
Le canvas offre une vue d’ensemble de toutes vos pages Figma, semblable à celle d’un Blockstudio, sous forme de plans de travail iframe actifs affichés dans une même vue. Faites glisser le doigt sur le pavé tactile pour vous déplacer, pincez ou utilisez Ctrl+molette pour zoomer.
Cet outil est utile avec des agents IA, car il donne une vue d’ensemble visuelle de toutes les pages sans changer d’onglet ni parcourir l’administration de WordPress. Lorsqu’un agent modifie un modèle de page, vous pouvez voir le résultat immédiatement. Activez le mode direct pour que le canvas s’actualise automatiquement lorsque les fichiers changent.
Activez-le dans blockstudio.json :
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Accédez ensuite à /wp-admin/admin.php?page=blockstudio-canvas. Passez de la vue des pages (plans de travail pleine largeur) à la vue des blocs (grille de tous les blocs enregistrés avec leurs valeurs par défaut).
Sélecteur d’élément
Le sélecteur d’élément résout un problème courant des flux IA : indiquer à l’agent quel fichier affiche un élément précis de la page.
Ajoutez ?blockstudio-devtools à n’importe quelle URL du frontend, puis maintenez Cmd+C (Mac) ou Ctrl+C (Windows) pendant 100 ms. Un sélecteur en forme de réticule s’active et met en évidence les blocs Blockstudio au passage du curseur. Cliquez sur un élément pour copier son contexte dans le presse-papiers :
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Collez ces informations dans votre outil de programmation IA : l’agent connaît aussitôt le chemin du fichier, la structure HTML et l’élément que vous désignez. Plus besoin de rechercher les chemins des fichiers de modèle à la main.
Activez-le dans blockstudio.json :
{
"dev": {
"grab": {
"enabled": true
}
}
}
Méthodes pratiques
Créer un bloc
La méthode la plus simple : décrivez ce que vous voulez et laissez l’agent le créer.
Prompt :
Crée un bloc de témoignage avec des champs pour le texte de la citation (textarea), le nom de l’auteur (text), son rôle (text) et sa photo (files). Utilise Tailwind pour les styles. La citation doit être affichée en grands caractères italiques, avec un guillemet décoratif.
L’agent va créer :
blockstudio/testimonial/
├── block.json
└── index.php
Créer une page complète
Les pages fondées sur des fichiers de Blockstudio permettent à un agent de créer l’ébauche d’une page WordPress complète sous forme de modèle. C’est là que réside le principal avantage : au lieu de créer les blocs un par un, l’agent produit en une seule fois toute la structure de la page et ses blocs.
Prompt :
Crée une page « À propos » avec une section d’en-tête, une grille d’équipe et un formulaire de contact provisoire. Utilise les blocs existants quand c’est possible et crée-en de nouveaux si nécessaire. Associe-la à l’ID de publication 2. Verrouille le modèle, mais autorise la modification du contenu des titres et des paragraphes.
L’agent crée :
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Ainsi que tous les blocs personnalisés auxquels il fait appel (e.g., blockstudio/team-member/). Exécutez
wp bs pages sync pour créer la publication WordPress avec son modèle verrouillé et
ses commandes d’édition. Toute la page est suivie dans le contrôle de version et reproductible.
Créer un site complet
C’est là que l’architecture de Blockstudio révèle tout son potentiel. Une seule instruction peut générer un site complet, car chaque élément est un fichier :
Prompt :
Crée un site portfolio avec ces pages : Accueil, Projets, À propos, Contact. Crée des blocs personnalisés pour : la section d’en-tête, la grille de projets, la fiche projet, le membre d’équipe, les coordonnées et le pied de page. Utilise un thème sombre avec Tailwind. Configure Tailwind dans blockstudio.json avec une palette de couleurs personnalisée.
L’agent crée les dossiers des blocs, les modèles de page, un blockstudio.json avec la configuration Tailwind et, en option, des compositions pour les sections réutilisables. Tout est validé dans git sous la forme d’un seul ensemble de modifications.
Flux de travail avec des agents en parallèle
Certains outils (l’application de bureau Codex, GitHub Copilot CLI, Kilo Code) permettent d’exécuter plusieurs agents en parallèle. L’architecture de Blockstudio, qui utilise un fichier par bloc, s’y prête bien :
- Agent 1 : crée le bloc d’en-tête et la page d’accueil
- Agent 2 : crée le bloc de fiche projet et la page des projets
- Agent 3 : crée le bloc de formulaire de contact et la page de contact
Comme chaque bloc se trouve dans son propre répertoire et que les styles Tailwind sont intégrés aux modèles, ces agents ne se gêneront pas. Le seul fichier partagé est blockstudio.json, qui n’a généralement besoin d’être configuré qu’une fois au début.
Conseils pour de meilleurs résultats
-
Indiquez le fichier de contexte du LLM. Les agents produisent un code Blockstudio nettement meilleur lorsqu’ils ont accès à la documentation du framework. Indiquez-leur toujours
blockstudio-llm.txtet fournissez-leur unAGENTS.mdgénéré pour le projet lui-même. -
Précisez les types de champs. Au lieu de dire « ajoute un champ image », dites « ajoute un champ files avec
allowedTypes: ['image']etreturnFormat: 'object'». Plus vos définitions de champs sont précises, moins il faudra d’itérations. -
Commencez par un bloc, puis passez à l’échelle. Laissez l’agent créer correctement un bloc, examinez ses méthodes, puis demandez-lui de créer les autres en suivant les mêmes conventions. Vous obtiendrez ainsi une référence qui améliorera les résultats suivants.
-
Vérifiez le résultat. Le vibe coding ne signifie pas qu’il faut accepter le code sans le vérifier. Assurez-vous que les types de champs correspondent à vos besoins, que les modèles s’affichent correctement et que les classes Tailwind produisent le résultat visuel attendu. Le code généré par IA doit être examiné avant sa mise en production.
-
Utilisez les schémas
block.json. Blockstudio fournit un schéma JSON danshttps://blockstudio.dev/schema/block. Ajoutez"$schema"à votre block.json pour que les agents reçoivent des retours de validation et évitent les configurations mal formées. -
Gardez des blocs petits et ciblés. Un bloc par composant visuel. L’agent peut ainsi raisonner plus facilement sur chaque bloc, et les modèles restent assez courts pour tenir dans une seule fenêtre de contexte.