Zum Inhalt springen

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:

Code
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:

Code
pages/about/
├── page.json     # Title, slug, post type, template lock
└── index.php     # Block structure as HTML
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:

PHP
<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 Google 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:

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.

Markdown
# 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:

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:

Code
@<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:

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:

Code
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:

Code
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

  1. 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.txt und gib ihnen eine generierte AGENTS.md für das Projekt.

  2. Gib Feldtypen genau an. Statt „Füge ein Bildfeld hinzu“ sage „Füge ein Dateifeld mit allowedTypes: ['image'] und returnFormat: 'object' hinzu.“ Je genauer deine Felddefinitionen sind, desto weniger Durchläufe sind nötig.

  3. 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.

  4. 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.

  5. Verwende block.json-Schemas. Blockstudio stellt unter https://blockstudio.dev/schema/block ein JSON-Schema bereit. Fügst du "$schema" zu deinem block.json hinzu, erhält der Agent Validierungshinweise und fehlerhafte Konfigurationen werden verhindert.

  6. 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.