Vibecoding met Blockstudio
Andrej Karpathy bedacht de term “vibe coding” in februari 2025 voor een werkwijze waarbij je aan een AI beschrijft wat je wilt en die de code schrijft. Een jaar later is deze praktijk uitgegroeid tot wat hij nu “agentic engineering” noemt: ontwikkelaars die AI-agents aansturen in plaats van regel voor regel code te schrijven.
Blockstudio is hiervoor ontwikkeld. De bestandsgebaseerde architectuur, het ontbreken van buildtools en de voorspelbare projectstructuur maken het een van de beste omgevingen voor AI-ondersteunde WordPress-ontwikkeling.
Deze gids behandelt praktische patronen voor het gebruik van AI-codeeragents met Blockstudio, van de projectconfiguratie tot het genereren van een volledige site.
Waarom Blockstudio goed werkt met AI-agents
Bestanden, geen databases
AI-codeeragents lezen en schrijven bestanden. Dat is hun belangrijkste interface. Blockstudio bewaart alles in het bestandssysteem: een block.json en een templatebestand per block, een page.json per pagina en een pattern.json per patroon. Geen database-items om te beheren, geen admin-UI om door te klikken en geen buildstap om uit te voeren.
Dit is belangrijk omdat bestandssystemen en shellopdrachten tot de grootste bronnen van pretrainingdata voor LLM’s behoren. Elk model heeft miljoenen voorbeelden gezien van bestanden lezen, schrijven en ordenen. Wanneer je WordPress-ontwikkelworkflow op die interface aansluit, kunnen agents met minimale instructies aan de slag.
Voorspelbare structuur
Elk Blockstudio-block volgt hetzelfde patroon:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Dankzij deze consistentie kan een agent die één block heeft gebouwd er honderd bouwen. Er zijn geen verrassingen, uitzonderingen of verborgen configuraties. Hetzelfde patroon geldt voor pagina’s (page.json + template), patronen (pattern.json + template) en extensies (extend.json).
Volledige pagina’s als bestanden
Voor het bouwen van pagina’s in traditioneel WordPress is de block-editor nodig: blocks slepen, instellingen configureren en opslaan via de admin. AI-agents kunnen dat allemaal niet. Ze hebben bestanden nodig.
De Blockstudio-pagina’s op basis van bestanden van lossen dit volledig op. Een page.json bevat de paginametadata en een index.php-template bepaalt de blockstructuur met 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>
Een agent kan een volledige WordPress-pagina opzetten, inclusief core-blocks, aangepaste blocks, templateslot en bewerkingsopties, door slechts twee bestanden te schrijven. Voer wp bs pages sync uit om de bron toe te passen op WordPress; de admin openen voert die synchronisatie niet automatisch uit.
Dit is een van de krachtigste functies voor AI-ondersteunde ontwikkeling. In plaats van een pagina-indeling te beschrijven en die handmatig in de editor samen te stellen, beschrijf je de pagina aan een agent en schrijft die de template. Het resultaat is versiebeheerbaar, reproduceerbaar en kan binnen enkele seconden worden aangepast.
Geen buildstap
Er hoeft niets gecompileerd, gebundeld of getranspileerd te worden. Een agent maakt een bestand en het werkt meteen. SCSS wordt server-side gecompileerd. ES-modules worden tijdens runtime opgelost. Tailwind CSS wordt bij elk frontendverzoek gecompileerd. De feedbacklus tussen “agent schrijft code” en “code wordt in de browser uitgevoerd” is zo kort als maar kan.
Waarom Tailwind CSS de juiste keuze is
Blockstudio ondersteunt zowel gewone CSS als Tailwind CSS, maar Tailwind biedt een aanzienlijk voordeel bij het werken met AI-agents.
LLM’s kennen Tailwind door en door
Tailwind CSS wordt gebruikt in tienduizenden opensourcerepositories. Het vormt de basis voor de interfaces van Claude.ai, Vercel, Shopify, Cursor en de eigen producten van OpenAI. Door deze ruime vertegenwoordiging in trainingsdata genereren LLM’s Tailwind-klassen zeer nauwkeurig en verzinnen ze zelden niet-bestaande hulpprogramma’s.
De klassevocabulaire is eindig en duidelijk gedefinieerd. Een agent kan geen CSS-eigenschap verzinnen die niet bestaat, waardoor stijlfouten sterk afnemen vergeleken met vrije CSS, waarbij de agent ongeldige selectors kan genereren of het gedrag van de cascade verkeerd kan begrijpen.
Stijlen staan in de markup
Met Tailwind staan alle stijlgegevens samen in de HTML-template. Een agent ziet de volledige visuele beschrijving van een element op één plek. Je hoeft geen afzonderlijke .css-bestanden te raadplegen, de cascadevolgorde te begrijpen of conflicten in specificiteit bij te houden.
Dit is vooral krachtig voor Blockstudio-blocks, waarvan de template al uit één bestand bestaat. De agent kan in één keer een volledige, opgemaakte component genereren:
<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>
Parallelle agents zonder conflicten
Omdat Tailwind-stijlen beperkt zijn tot elke template, kunnen meerdere agents (of ontwikkelaars) tegelijk aan verschillende blocks werken zonder CSS-mergeconflicten. Er is geen gedeeld stylesheet waarin wijzigingen aan de ene component per ongeluk een andere beschadigen. Elk block staat op zichzelf.
Dit werkt ook goed met gewone CSS in combinatie met de beperkte stijlen (Blockstudio) van style.scoped.css, maar Tailwind maakt het CSS-bestand helemaal overbodig. Zo hoeft de agent per block één bestand minder te beheren.
Gewone CSS werkt nog steeds
Tailwind is niet vereist. De assetpipeline van Blockstudio verwerkt .css– en .scss-bestanden automatisch, inclusief stijlen die beperkt zijn tot een block en daarvan een eigen namespace krijgen. Gebruikt je project een andere CSS-methodologie, dan kunnen agents daar ook mee werken. Het voordeel van Tailwind is simpelweg dat LLM’s er beter mee overweg kunnen dankzij de aanwezigheid in trainingsdata en doordat de stijlen samen met de markup staan.
AI-codeeragents
De volgende CLI-tools werken direct met Blockstudio-projecten. Ze lezen en schrijven bestanden, voeren shellopdrachten uit en halen de projectstructuur op uit contextbestanden.
Terminalagents (CLI)
| Tool | Aanbieder | Opmerkingen |
|---|---|---|
| Claude Code | Anthropic | Agent die op de terminal is gericht. Leest CLAUDE.md voor projectcontext. |
| Codex CLI | OpenAI | Opensource-CLI gebouwd met Rust. Ook beschikbaar als desktopapp. |
| Gemini CLI | Opensource met een contextvenster van 1M tokens. Leest GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Gespecialiseerde parallelle agents voor verkennen, taken, plannen en beoordelen. |
| Aider | Open source | Ondersteunt meer dan 100 LLM-aanbieders, inclusief lokale modellen. |
| OpenCode | Open source | Terminal-TUI met LSP-integratie. Ondersteunt meer dan 75 aanbieders. |
| Amazon Q Developer CLI | AWS | Gratis abonnement beschikbaar. Geschikt voor projecten met AWS-integratie. |
IDE-agents
| Tool | Aanbieder | Opmerkingen |
|---|---|---|
| Cursor | Cursor | VS Code-fork met ingebouwde AI. Heeft ook een CLI (bèta). |
| Windsurf | Cognition AI | VS Code-fork met de agentische assistent Cascade. |
| Cline | Open source | VS Code-extensie met stapsgewijze goedkeuring. Heeft ook een CLI. |
| Kilo Code | Open source | Orkestratiemodus met gecoördineerde subagents. |
| Continue | Open source | VS Code/JetBrains-extensie met asynchrone CI/CD-agents. |
| Augment Code | Augment | Gericht op ondernemingen, met uitgebreide indexering van codebases. |
Al deze tools kunnen bestanden maken en bewerken in een Blockstudio-projectmap. Terminalagents zijn bijzonder geschikt, omdat Blockstudio-ontwikkeling geen IDE-specifieke functies vereist: alles is gebaseerd op bestanden.
Je project instellen voor AI-agents
Het LLM-contextbestand
Blockstudio wordt geleverd met een vooraf gemaakt contextbestand dat de volledige frameworkdocumentatie indexeert. Het is geen samenvatting of spiekbriefje: elk document wordt één keer vermeld met de route, het doel en de identifiers die erbij horen. Zo kan een agent de pagina vinden die antwoord geeft op een vraag en alleen die pagina openen. De volledige tekst van elk document en schema blijft beschikbaar in een tweede bestand voor tools die het hele corpus in één keer nodig hebben.
Schakel het in via je blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
De index is nu beschikbaar op your-site.com/blockstudio-llm.txt en de volledige tekst op your-site.com/blockstudio-llm-full.txt. Wijs je AI-tool naar de index, zodat die zonder extra instructies toegang heeft tot de volledige Blockstudio API. Bekijk de integratiedocumentatie voor AI voor instellingsinstructies per tool.
Zo hoef je zelf geen frameworkspecifieke instructies te schrijven. Een agent met toegang tot blockstudio-llm.txt kan opzoeken hoe je blocks maakt, velden definieert, templates schrijft, Tailwind configureert, pagina’s instelt en alle hooks van Blockstudio gebruikt.
Projectspecifieke contextbestanden
De meeste AI-codeeragents lezen ook een contextbestand op projectniveau met instructies die specifiek zijn voor je codebase. De conventie verschilt per tool:
| Bestand | Tool |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI en andere |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Omdat blockstudio-llm.txt het framework al behandelt, hoeft je projectcontextbestand alleen te beschrijven wat uniek is voor je project: de mapindeling, naamgevingsconventies, opdrachten en grenzen.
Als je blockstudio/phpstan installeert, hoef je die beschrijving niet zelf te schrijven. vendor/bin/blockstudio-agents maakt een AGENTS.md op basis van je blockstudio.json en je eigen bestanden. Daarin staat wat de projectauteurs doen, welke functies zijn ingeschakeld, wat de analyse afkeurt en welke opdrachten van toepassing zijn. Het overschrijft geen bestand dat het zelf niet heeft gemaakt en behoudt je eigen notities wanneer je het opnieuw genereert.
# 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
Ontwikkelaarstools voor AI-workflows
Blockstudio bevat twee ontwikkelaarstools die speciaal zijn ontworpen voor AI-ondersteunde ontwikkeling.
Canvas
De canvas is een Figma-achtig overzicht van al je Blockstudio-pagina’s, weergegeven als live iframe-artboards in één weergave. Versleep met je trackpad en zoom met knijpen of Ctrl+scrollen.
Dit is handig bij het werken met AI-agents, omdat je een visueel overzicht van elke pagina krijgt zonder van tabblad te wisselen of door de WordPress-admin te navigeren. Wanneer een agent een paginatemplate aanpast, zie je het resultaat meteen. Schakel de livemodus in en het canvas wordt automatisch vernieuwd wanneer bestanden veranderen.
Schakel het in via blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Navigeer vervolgens naar /wp-admin/admin.php?page=blockstudio-canvas. Wissel tussen de paginaweergave (artboards over de volledige breedte) en de blockweergave (een raster met alle geregistreerde blocks en standaardwaarden).
Element Grabber
De element grabber lost een veelvoorkomend probleem in AI-workflows op: aan de agent doorgeven welk bestand een specifiek element op de pagina weergeeft.
Voeg ?blockstudio-devtools toe aan een willekeurige frontend-URL en houd vervolgens Cmd+C (Mac) of Ctrl+C (Windows) 100ms ingedrukt. Er verschijnt een dradenkruis waarmee je elementen kunt selecteren; Blockstudio-blocks worden gemarkeerd wanneer je eroverheen beweegt. Klik op een element om de context ervan naar het klembord te kopiëren:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Plak dit in je AI-codeertool en de agent weet meteen het bestandspad, de HTML-structuur en het element waarnaar je verwijst. Je hoeft templatebestandspaden niet meer handmatig op te zoeken.
Schakel het in via blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Praktische patronen
Eén block bouwen
De eenvoudigste workflow: beschrijf wat je wilt en laat de agent het maken.
Prompt:
Maak een testimonial-block met velden voor de quote (textarea), de naam van de auteur (text), de functie van de auteur (text) en de foto van de auteur (files). Gebruik Tailwind voor de opmaak. Zet de quote in een groot, cursief lettertype met een decoratief aanhalingsteken.
De agent maakt het volgende aan:
blockstudio/testimonial/
├── block.json
└── index.php
Een volledige pagina bouwen
Met de Blockstudio-pagina’s op basis van bestanden van kan een agent een volledige WordPress-pagina als template opzetten. Hier zie je het grootste voordeel: in plaats van blocks één voor één te bouwen, maakt de agent in één keer de volledige paginastructuur met alle blocks.
Prompt:
Maak een pagina ‘Over ons’ met een hero-sectie, een teamraster en een plaatshouder voor een contactformulier. Gebruik waar mogelijk bestaande blocks en maak nieuwe waar nodig. Koppel de pagina aan bericht-ID 2. Vergrendel de template, maar maak koppen en alinea’s bewerkbaar.
De agent maakt het volgende aan:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Plus alle aangepaste blocks waarnaar wordt verwezen (e.g, blockstudio/team-member/). Voer
wp bs pages sync uit om het WordPress-bericht te maken, inclusief de templateslot en
bewerkingsopties. De volledige pagina is versiebeheerbaar en reproduceerbaar.
Een volledige site bouwen
Hier komt de architectuur van Blockstudio echt tot zijn recht. Eén prompt kan een volledige site genereren, omdat elk onderdeel een bestand is:
Prompt:
Bouw een portfoliowebsite met de volgende pagina’s: Home, Werk, Over ons, Contact. Maak aangepaste blocks voor: hero-sectie, projectraster, projectkaart, teamlid, contactgegevens en footer. Gebruik een donker thema met Tailwind. Configureer Tailwind in blockstudio.json met een aangepast kleurenpalet.
De agent maakt de blockmappen, paginatemplates en een blockstudio.json met Tailwind-configuratie, en eventueel patronen voor herbruikbare secties. Alles wordt als één changeset vastgelegd in git.
Parallelle agentworkflows
Sommige tools (desktopapp van Codex, GitHub Copilot CLI, Kilo Code) ondersteunen meerdere agents tegelijk. Dankzij de block-per-bestand-architectuur van Blockstudio is dit veilig:
- Agent 1: bouwt het hero-block en de homepage
- Agent 2: bouwt het projectkaart-block en de werkpagina
- Agent 3: bouwt het contactformulier-block en de contactpagina
Omdat elk block een eigen map heeft en Tailwind-stijlen in templates staan, werken deze agents elkaar niet in de weg. Het enige gedeelde bestand is blockstudio.json, dat doorgaans alleen bij de start hoeft te worden ingesteld.
Tips voor betere resultaten
-
Verwijs naar het LLM-contextbestand. Agents leveren aanzienlijk betere Blockstudio-code wanneer ze de frameworkdocumentatie kunnen raadplegen. Verwijs ze altijd naar
blockstudio-llm.txten geef ze een gegenereerdeAGENTS.mdvoor het project zelf. -
Geef veldtypen duidelijk aan. Zeg in plaats van "voeg een afbeeldingsveld toe": "voeg een files-veld toe met
allowedTypes: ['image']enreturnFormat: 'object'." Hoe preciezer je velddefinities zijn, hoe minder aanpassingsrondes nodig zijn. -
Begin met één block en schaal daarna op. Laat de agent één block goed bouwen, bekijk de patronen en vraag hem daarna de rest volgens dezelfde conventies te maken. Zo ontstaat een voorbeeld dat de volgende resultaten verbetert.
-
Controleer de uitvoer. Vibe coding betekent niet dat je code blindelings accepteert. Controleer of de veldtypen overeenkomen met je bedoeling, templates goed worden weergegeven en Tailwind-klassen het gewenste visuele resultaat opleveren. Controleer AI-gegenereerde code voordat je die uitrolt.
-
Gebruik
block.json-schema’s. Blockstudio biedt een JSON-schema ophttps://blockstudio.dev/schema/block. Door"$schema"aan je block.json toe te voegen, krijgen agents validatiefeedback en voorkom je ongeldige configuraties. -
Houd blocks klein en doelgericht. Gebruik één block per visuele component. Zo kan de agent elk block makkelijker verwerken en blijven templates kort genoeg voor één doorgang binnen het contextvenster.