Vibecoding mit Blockstudio
Andrej Karpathy prägte im Februar 2025 den Begriff „Vibe Coding“ für einen Arbeitsablauf, bei dem du einer KI beschreibst, was du möchtest, und sie den Code schreibt. Ein Jahr später hat sich diese Praxis zu dem entwickelt, was er nun „agentic engineering“ nennt: Entwickler koordinieren KI-Agenten, anstatt Code Zeile für Zeile zu schreiben.
Blockstudio wurde dafür entwickelt. Die dateibasierte Architektur, der Verzicht auf Build-Tools und die vorhersehbare Projektstruktur machen es zu einer der besten Umgebungen für KI-gestützte WordPress-Entwicklung.
Dieser Leitfaden behandelt praktische Muster für den Einsatz von KI-Coding-Agenten mit Blockstudio – von der Projekteinrichtung bis zur Erstellung vollständiger Websites.
Warum Blockstudio gut mit KI-Agenten funktioniert
Dateien statt Datenbanken
KI-Coding-Agenten lesen und schreiben Dateien. Das ist ihre wichtigste Schnittstelle. Blockstudio speichert alles im Dateisystem: eine block.json– und eine Vorlagendatei pro Block, eine page.json pro Seite und eine pattern.json pro Muster. Keine Datenbankeinträge, die du verwalten musst, keine Admin-UI, durch die du dich klicken musst, und kein Build-Schritt, den du ausführen musst.
Das ist wichtig, weil Dateisysteme und Shell-Befehle zu den größten Quellen von Trainingsdaten für LLMs zählen. Jedes Modell hat Millionen Beispiele zum Lesen, Schreiben und Organisieren von Dateien gesehen. Wenn dein WordPress-Entwicklungsablauf zu dieser Schnittstelle passt, können Agenten mit minimalen Anweisungen arbeiten.
Vorhersehbare Struktur
Jeder Blockstudio-Block folgt demselben Muster:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Dank dieser Einheitlichkeit kann ein Agent, der einen Block erstellt hat, auch hundert erstellen. Es gibt keine Überraschungen, Sonderfälle oder versteckte Konfigurationen. Dasselbe Muster gilt für Seiten (page.json + Vorlage), Muster (pattern.json + Vorlage) und Erweiterungen (extend.json).
Vollständige Seiten als Dateien
Für herkömmliche WordPress-Seiten brauchst du den Block-Editor: Blöcke ziehen, Einstellungen konfigurieren und im Adminbereich speichern. KI-Agenten können das alles nicht. Sie brauchen Dateien.
Die dateibasierten Seiten von Blockstudio lösen dieses Problem vollständig. Eine page.json definiert die Metadaten der Seite, und eine index.php-Vorlage legt mit HTML die Blockstruktur fest:
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>
Ein Agent kann eine vollständige WordPress-Seite mit Core-Blöcken, eigenen Blöcken, Vorlagensperre und Bearbeitungssteuerungen erstellen – und das mit nur zwei Dateien. Führe wp bs pages sync aus, um den Quellstand auf WordPress anzuwenden. Beim Öffnen des Adminbereichs wird diese Synchronisierung nicht automatisch ausgeführt.
Dies ist eine der leistungsstärksten Funktionen für KI-gestützte Entwicklung. Statt ein Seitenlayout zu beschreiben und es manuell im Editor zusammenzustellen, beschreibst du es einem Agenten, der die Vorlage schreibt. Das Ergebnis ist versionskontrolliert, reproduzierbar und lässt sich in Sekunden überarbeiten.
Kein Build-Schritt
Es muss nichts kompiliert, gebündelt oder transpiliert werden. Ein Agent erstellt eine Datei, und sie funktioniert sofort. SCSS wird serverseitig kompiliert. ES-Module werden zur Laufzeit aufgelöst. Tailwind CSS wird bei jeder Frontend-Anfrage kompiliert. Die Feedbackschleife zwischen „Agent schreibt Code“ und „Code läuft im Browser“ ist so kurz wie möglich.
Warum Tailwind CSS die richtige Wahl ist
Blockstudio unterstützt sowohl reguläres CSS als auch Tailwind CSS, aber Tailwind hat bei der Arbeit mit KI-Agenten einen deutlichen Vorteil.
LLMs kennen Tailwind sehr gut
Tailwind CSS wird in Zehntausenden Open-Source-Repositories verwendet. Es bildet die Grundlage für die Oberflächen von Claude.ai, Vercel, Shopify, Cursor und den eigenen Produkten von OpenAI. Durch diese weite Verbreitung in Trainingsdaten erzeugen LLMs Tailwind-Klassen sehr präzise und erfinden nur selten nicht vorhandene Hilfsklassen.
Das Klassenvokabular ist endlich und klar definiert. Ein Agent kann keine CSS-Eigenschaft erfinden, die es nicht gibt. Dadurch sinkt die Zahl der Stilierungsfehler deutlich im Vergleich zu freiem CSS, bei dem der Agent ungültige Selektoren erzeugen oder das Kaskadenverhalten falsch verstehen könnte.
Styles stehen im Markup
Mit Tailwind stehen alle Stilinformationen gemeinsam in der HTML-Vorlage. Ein Agent sieht die vollständige visuelle Beschreibung eines Elements an einem Ort. Separate .css-Dateien müssen nicht abgeglichen, die Kaskadenreihenfolge nicht verstanden und Spezifitätskonflikte nicht nachverfolgt werden.
Das ist besonders nützlich für Blockstudio-Blöcke, deren Vorlage bereits aus einer einzigen Datei besteht. Der Agent kann eine vollständige, gestaltete Komponente in einem Durchgang erstellen:
<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>
Parallele Agenten ohne Konflikte
Da Tailwind-Styles auf die jeweilige Vorlage beschränkt sind, können mehrere Agenten (oder Entwickler) gleichzeitig an unterschiedlichen Blöcken arbeiten, ohne CSS-Merge-Konflikte zu verursachen. Es gibt kein gemeinsames Stylesheet, in dem Änderungen an einer Komponente versehentlich eine andere beeinträchtigen. Jeder Block ist eigenständig.
Das funktioniert auch mit regulärem CSS gut, wenn du die Scoped Styles von Blockstudio (style.scoped.css) verwendest. Tailwind macht die CSS-Datei jedoch ganz überflüssig. Damit muss der Agent pro Block eine Datei weniger verwalten.
Reguläres CSS funktioniert weiterhin
Tailwind ist keine Voraussetzung. Die Asset-Pipeline von Blockstudio verarbeitet .css– und .scss-Dateien automatisch, einschließlich Scoped Styles, deren Namen auf den jeweiligen Block beschränkt sind. Wenn dein Projekt eine andere CSS-Methodik verwendet, können Agenten auch damit arbeiten. Tailwinds Vorteil besteht lediglich darin, dass LLMs es dank der Abdeckung in Trainingsdaten und der gemeinsamen Ablage von Styles und Markup besser beherrschen.
KI-Coding-Agenten
Die folgenden CLI-Tools können direkt mit Blockstudio-Projekten arbeiten. Sie lesen und schreiben Dateien, führen Shell-Befehle aus und verstehen anhand von Kontextdateien die Projektstruktur.
Terminal-Agenten (CLI)
| Tool | Anbieter | Hinweise |
|---|---|---|
| Claude Code | Anthropic | Agent mit Fokus auf das Terminal. Liest CLAUDE.md als Projektkontext. |
| Codex CLI | OpenAI | Open-Source-CLI in Rust. Auch als Desktop-App verfügbar. |
| Gemini CLI | Open Source mit einem Kontextfenster von 1M Token. Liest GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Spezialisierte parallele Agenten für Erkundung, Aufgaben, Planung und Überprüfung. |
| Aider | Open Source | Unterstützt über 100 LLM-Anbieter, darunter lokale Modelle. |
| OpenCode | Open Source | Terminal-TUI mit LSP-Integration. Unterstützt über 75 Anbieter. |
| Amazon Q Developer CLI | AWS | Kostenlose Version verfügbar. Besonders geeignet für AWS-integrierte Projekte. |
IDE-Agenten
| Werkzeug | Anbieter | Hinweise |
|---|---|---|
| Cursor | Cursor | VS Code-Fork mit integrierter KI. Bietet auch eine CLI (Beta). |
| Windsurf | Cognition AI | VS Code-Fork mit agentenbasiertem Cascade-Assistenten. |
| Cline | Open Source | VS Code-Erweiterung mit schrittweiser Genehmigung. Bietet auch eine CLI. |
| Kilo Code | Open Source | Orchestrator-Modus mit koordinierten Subagenten. |
| Continue | Open Source | VS Code/JetBrains-Erweiterung mit asynchronen CI/CD-Agenten. |
| Augment Code | Augment | Für Unternehmen, mit detaillierter Codebasis-Indexierung. |
Alle diese Tools können Dateien in einem Blockstudio-Projektverzeichnis erstellen und bearbeiten. Terminal-Agenten eignen sich besonders gut, da die Blockstudio-Entwicklung keine IDE-spezifischen Funktionen benötigt: Sie basiert vollständig auf Dateien.
Dein Projekt für KI-Agenten einrichten
Die LLM-Kontextdatei
Blockstudio enthält eine vorgefertigte Kontextdatei, die die vollständige Framework-Dokumentation indexiert. Sie ist weder eine Zusammenfassung noch ein Spickzettel: Jedes Dokument wird einmal mit seinem Pfad, Zweck und den darin definierten Bezeichnern aufgeführt. So findet ein Agent die passende Seite und öffnet nur diese. Der vollständige Text aller Dokumente und Schemas bleibt in einer zweiten Datei für Tools verfügbar, die den gesamten Inhalt auf einmal benötigen.
Aktiviere sie in deiner blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
Der Index ist jetzt unter your-site.com/blockstudio-llm.txt verfügbar, der vollständige Text unter your-site.com/blockstudio-llm-full.txt. Verweise dein KI-Tool auf den Index, damit es ohne zusätzliche Anweisungen auf die gesamte Blockstudio API zugreifen kann. In der Dokumentation zur KI-Integration findest du die Einrichtung für einzelne Tools.
Damit brauchst du keine eigenen frameworkspezifischen Anweisungen mehr zu schreiben. Ein Agent mit Zugriff auf blockstudio-llm.txt findet heraus, wie man Blöcke erstellt, Felder definiert, Vorlagen schreibt, Tailwind konfiguriert, Seiten einrichtet und jeden von Blockstudio bereitgestellten Hook verwendet.
Projektspezifische Kontextdateien
Die meisten KI-Coding-Agenten lesen auch eine Kontextdatei auf Projektebene mit Anweisungen zu deiner Codebasis. Die Konvention hängt vom Tool ab:
| Datei | Tool |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI und andere |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Da blockstudio-llm.txt das Framework bereits abdeckt, muss deine Projektkontextdatei nur beschreiben, was an deinem Projekt speziell ist: Verzeichnisstruktur, Namenskonventionen, Befehle und Grenzen.
Wenn du blockstudio/phpstan installierst, musst du diese Beschreibung nicht von Hand schreiben. vendor/bin/blockstudio-agents erstellt anhand deiner AGENTS.md und deiner eigenen Dateien eine blockstudio.json. Darin steht, was im Projekt erstellt wird, welche Funktionen aktiviert sind, was bei der Analyse abgelehnt wird und welche Befehle gelten. Das Tool überschreibt keine Datei, die es nicht selbst erstellt hat, und erhält deine eigenen Notizen beim erneuten Erstellen.
# 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
Entwicklerwerkzeuge für KI-Workflows
Blockstudio enthält zwei Entwicklerwerkzeuge, die speziell für KI-gestützte Entwicklung konzipiert sind.
Canvas
Der Canvas bietet eine Figma-ähnliche Übersicht über alle Blockstudio-Seiten. Sie werden in einer einzigen Ansicht als Live-IFrame-Artboards dargestellt. Bewege die Ansicht mit dem Trackpad und zoome per Pinch-Geste oder mit Strg+Scrollen.
Das ist bei der Arbeit mit KI-Agenten nützlich, weil du alle Seiten visuell überblickst, ohne Tabs zu wechseln oder durch die WordPress-Administration zu navigieren. Ändert ein Agent eine Seitenvorlage, siehst du das Ergebnis sofort. Aktiviere den Live-Modus, damit die Canvas-Ansicht bei Dateiänderungen automatisch aktualisiert wird.
Aktiviere es in blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Navigiere dann zu /wp-admin/admin.php?page=blockstudio-canvas. Wechsle zwischen der Seitenansicht (Artboards in voller Breite) und der Blockansicht (Raster aller registrierten Blöcke mit Standardwerten).
Element Grabber
Der Element Grabber löst ein häufiges Problem bei KI-Workflows: dem Agenten mitzuteilen, welche Datei ein bestimmtes Element auf der Seite rendert.
Füge ?blockstudio-devtools an eine beliebige Frontend-URL an und halte dann 100 ms lang Cmd+C (Mac) oder Ctrl+C (Windows) gedrückt. Ein Fadenkreuz erscheint und hebt Blockstudio-Blöcke beim Darüberfahren hervor. Klicke auf ein Element, um seinen Kontext in die Zwischenablage zu kopieren:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Füge dies in dein KI-Coding-Tool ein, damit der Agent sofort den Dateipfad, die HTML-Struktur und das Element kennt, auf das du zeigst. Die Vorlagendatei musst du nicht mehr manuell suchen.
Aktiviere es in blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Praktische Muster
Einen einzelnen Block erstellen
Der einfachste Workflow: Beschreibe, was du möchtest, und lass den Agenten den Block erstellen.
Prompt:
Erstelle einen Testimonial-Block mit Feldern für Zitat (Textarea), Name des Autors (Text), Rolle des Autors (Text) und Foto des Autors (Dateien). Verwende Tailwind für die Gestaltung. Das Zitat soll in großer kursiver Schrift mit einem dekorativen Anführungszeichen erscheinen.
Der Agent erstellt:
blockstudio/testimonial/
├── block.json
└── index.php
Eine vollständige Seite erstellen
Mit den Blockstudio-dateibasierten Seiten kann ein Agent eine vollständige WordPress-Seite als Vorlage erstellen. Hier zeigt sich der große Vorteil: Statt Blöcke einzeln zu erstellen, erzeugt der Agent in einem Durchgang die gesamte Seitenstruktur mit allen Blöcken.
Prompt:
Erstelle eine „Über uns“-Seite mit Hero-Bereich, Team-Raster und Platzhalter für ein Kontaktformular. Verwende nach Möglichkeit vorhandene Blöcke und erstelle neue, wo sie gebraucht werden. Verknüpfe die Seite mit der Beitrags-ID 2. Sperre die Vorlage, aber mache Überschriften und Absätze bearbeitbar.
Der Agent erstellt:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Außerdem erstellt er alle referenzierten benutzerdefinierten Blöcke (e.g., blockstudio/team-member/). Führe
wp bs pages sync aus, um den WordPress-Beitrag mit Vorlagensperre und
Bearbeitungsoptionen zu erstellen. Die gesamte Seite ist versioniert und reproduzierbar.
Eine vollständige Website erstellen
Hier kommt die Architektur von Blockstudio besonders zur Geltung. Ein einzelner Prompt kann eine ganze Website erzeugen, weil jedes Element eine Datei ist:
Prompt:
Erstelle eine Portfolio-Website mit diesen Seiten: Startseite, Arbeiten, Über uns, Kontakt. Erstelle benutzerdefinierte Blöcke für: Hero-Bereich, Projektraster, Projektkarte, Teammitglied, Kontaktinformationen und Footer. Verwende ein dunkles Design mit Tailwind. Richte Tailwind in blockstudio.json mit einer eigenen Farbpalette ein.
Der Agent erstellt die Blockverzeichnisse, Seitentemplates, ein blockstudio.json mit Tailwind-Konfiguration und optional Patterns für wiederverwendbare Abschnitte. Alles wird als einzelner Changeset in git committet.
Parallele Agenten-Workflows
Einige Tools (Codex-Desktop-App, GitHub Copilot CLI, Kilo Code) unterstützen den parallelen Einsatz mehrerer Agenten. Dank der dateibasierten Architektur von Blockstudio ist das sicher:
- Agent 1: erstellt den Hero-Block und die Startseite
- Agent 2: erstellt den Projektkarten-Block und die Seite „Arbeiten“
- Agent 3: erstellt den Kontaktformular-Block und die Kontaktseite
Da jeder Block ein eigenes Verzeichnis hat und Tailwind-Styles gemeinsam mit den Vorlagen abgelegt sind, geraten diese Agenten nicht in Konflikt. Die einzige gemeinsam genutzte Datei ist blockstudio.json, die normalerweise nur zu Beginn einmal eingerichtet werden muss.
Tipps für bessere Ergebnisse
-
Verweise auf die LLM-Kontextdatei. Agenten erzeugen deutlich besseren Blockstudio-Code, wenn sie auf die Framework-Dokumentation zugreifen können. Verweise sie immer auf
blockstudio-llm.txtund gib ihnen eine generierteAGENTS.mdfür das Projekt. -
Gib Feldtypen genau an. Statt „Füge ein Bildfeld hinzu“ sage „Füge ein Dateifeld mit
allowedTypes: ['image']undreturnFormat: 'object'hinzu.“ Je genauer deine Felddefinitionen sind, desto weniger Durchläufe sind nötig. -
Beginne mit einem Block und erweitere dann. Lass den Agenten einen Block korrekt erstellen, prüfe seine Muster und bitte ihn dann, die übrigen nach denselben Konventionen zu erstellen. So entsteht eine Referenz, die die folgenden Ergebnisse verbessert.
-
Prüfe das Ergebnis. Vibe-Coding bedeutet nicht, Code blind zu übernehmen. Prüfe, ob die Feldtypen deinen Vorstellungen entsprechen, die Vorlagen korrekt gerendert werden und die Tailwind-Klassen das gewünschte Ergebnis liefern. KI-generierter Code sollte vor der Veröffentlichung überprüft werden.
-
Verwende
block.json-Schemas. Blockstudio stellt unterhttps://blockstudio.dev/schema/blockein JSON-Schema bereit. Fügst du"$schema"zu deinem block.json hinzu, erhält der Agent Validierungshinweise und fehlerhafte Konfigurationen werden verhindert. -
Halte Blöcke klein und fokussiert. Ein Block pro visueller Komponente. So kann der Agent jeden Block leichter nachvollziehen, und die Vorlagen bleiben kurz genug für einen einzigen Durchlauf im Kontextfenster.