Zum Inhalt springen

KI-native Blockentwicklung

Dateien und kein Buildschritt – genau das liegt Agents.

Eine stumme Bildschirmaufnahme: Ein Coding-Agent erstellt mit einem einzigen Prompt eine vollständige WordPress-Website mit 10 benutzerdefinierten Blöcken und 6 Seiten.

Beschreibe einen Block, erhalte einen Block

KI-Coding-Agenten können mit einem Prompt Blöcke, Seiten und Muster erstellen. Keine GUI und keine Datenbank, nur Dateien.

~/starter-theme

❯ Erstelle einen Preisblock mit drei Tarifen, einem Monats-/Jahres-Schalter und einem CTA für jeden Tarif.

✓ Erstellt pricing/block.json

✓ Erstellt pricing/index.php

✓ Erstellt pricing/style.css

❯ Erstelle jetzt eine Preisseite mit Hero- und FAQ-Abschnitt.

✓ Erstellt pages/pricing/page.json

✓ Erstellt pages/pricing/index.php

Dateien

blockstudio/

├── pricing/ Neu

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Neu

├── page.json

└── index.php

Alles dateibasiert

Blöcke, Seiten, Muster und Erweiterungen sind Verzeichnisse mit JSON-Konfiguration und Vorlagen. Agents lesen und bearbeiten sie direkt.

Keine Datenbankkonfiguration

Keine Admin-Oberflächen zum Durchklicken. Jede Einstellung ist ein JSON-Schlüssel, sodass ein Agent die Bibliothek ohne Browser anlegen kann.

Vorhersehbare Struktur

Jeder Block folgt derselben Konvention: block.json, eine Vorlage und optionale Stile. Das Muster einmal lernen.

Kontext statt Vermutungen

Ein kompakter Dokumentationsindex plus der vollständige Text für Tools, die alles benötigen.

Ein Index, den der Agent zuerst liest

blockstudio-llm.txt listet jedes Dokument einmal mit Route, Quelldatei, Zweck sowie den zugehörigen Einstellungen, Hooks, PHP-Funktionen und CLI-Befehlen auf. Mit etwa 11k Tokens liest ein Agent den Index vollständig und öffnet dann nur die benötigte Seite.

blockstudio-llm-full.txt enthält alle Dokumente und das JSON-Schema in einer Datei mit etwa 169k Tokens – für Tools, die den gesamten Bestand benötigen. ai.enableContextGeneration aktivieren, dann stellt deine Website beides bereit.

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.

Ein Vertrag für dein Projekt

Die Dokumentation beschreibt Blockstudio. AGENTS.md beschreibt das Projekt, das der Agent gleich ändert.

Ein Befehl schreibt AGENTS.md

vendor/bin/blockstudio-agents beschreibt das Projekt, in dem es ausgeführt wird: seine Inhalte, die von blockstudio.json aktivierten Funktionen, die von der Analyse beanstandeten Punkte und die geltenden Befehle.

Jede Zeile stammt aus deinen Dateien, Einstellungen oder dem gewählten Analyseprofil. Beim Neuerstellen bleiben deine handschriftlichen Notizen erhalten, und --check schlägt fehl, wenn der Vertrag veraltet ist.

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.

Fehler vor dem Commit erkennen

Vier Analyse-Voreinstellungen, von denen jede den Umfang der vorherigen erweitert, sowie ein Hook, der sie bei jedem Commit ausführt.

Analyse mit Kenntnis von block.json

Die blockstudio/phpstan-Profile prüfen deine Blöcke, Seiten und Einstellungen. Liest eine Vorlage ein Feld, das ihr block.json nicht deklariert hat, oder gibt es ungefiltert aus, schlägt die Analyse fehl.

Vorlagen lesen ein $a, das neben ihnen aus dem block.json geladen wird, mit einem konkreten PHP-Typ für jeden Feldtyp, und Db::get() gibt Datensätze zurück, die nach db.php aufgebaut sind. Ein falsch geschriebener Einstellungspfad oder Hook-Name führt zu einem Fehler mit Vorschlag des ähnlichsten gültigen Namens.

githooks.commit einrichten und vendor/bin/blockstudio-githooks sync ausführen: Der verwaltete Pre-Commit-Hook startet dieselbe Analyse, damit kein fehlerhafter Block in einen Commit gelangt.

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

Bestandsaufnahme und Rendering aus PHP

Mit wenigen Aufrufen kann ein Agent sehen, was ein Projekt registriert, beliebige Teile davon rendern und prüfen, was es gespeichert hat.

Das Projekt abfragen, die Antwort rendern

Canvas::inventory() gibt jede registrierte Seite, jeden Block und jedes Muster, jede Site-Editor-Vorlage und jeden Vorlagenteil sowie jedes UI-Beispiel zurück, ohne etwas zu rendern.

Render::document() rendert jedes davon als vollständiges HTML-Dokument mit genau den verwendeten Assets, damit ein Agent seine Arbeit außerhalb des Editors prüfen kann.

Canvas::documents() rendert genau die von dir ausgewählten Datensätze. Render::composition() und Render::content() geben verschachtelte Deklarationen oder serialisierte Blockinhalte als HTML zurück, und Ui::inventory() sowie Ui::examples() listen die gebündelten Komponentenfamilien mit jeweils einer renderbaren Deklaration auf.

Für einen Block geben bs_block_fields(), bs_block_extension_fields(), bs_block_values() und bs_block_assets() seine Felder, Werte und Assets zurück, ohne ihn zu rendern, und bs_validate_block() prüft gespeicherte Attribute, bevor du sie speicherst.

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']);

Weniger als halb so viele Tokens pro Seite

Agents schreiben einfaches HTML. Blockstudio wandelt es beim Synchronisieren in serialisiertes WordPress-Block-Markup um: weniger zu generieren und weniger Fehlerquellen.

Blockstudio

Was Agenten schreiben

Etwa 135 Tokens
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

Was der Parser dafür schreibt

Etwa 310 Tokens
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 -->

Gemessen an den beiden obigen Panels: 540 Zeichen HTML im Vergleich zu 1,233 Zeichen Block-Markup, die der Standard-Parser dafür schreibt, geteilt durch vier, die übliche Schätzung der Zeichen pro Token. Das Markup wird zur besseren Lesbarkeit mit hinzugefügten Zeilenumbrüchen angezeigt.

Weniger Ausgabe generieren

Agents schreiben HTML ohne Blockbegrenzer, generierte Klassen oder Wrapper-Markup.

Weniger Fehlerquellen

Der Parser garantiert gültige Blockausgabe aus der einfacheren Eingabe.

Schneller und günstiger

Weniger Ausgabetokens bedeuten schnellere Antworten und geringere Modellkosten.

Funktioniert mit jedem KI-Coding-Tool

Jeder Agent, der Dateien lesen und schreiben kann, funktioniert sofort mit Blockstudio.

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

Für den KI-Workflow entwickelt

Blöcke, Seiten, Muster und Einstellungen: Alles ist eine Datei, die ein Agent lesen, schreiben und bearbeiten kann.

Zwei Dateien pro Block

Eine JSON-Konfiguration und eine Vorlage bilden den ganzen Block. Die kleine Oberfläche macht die erste Generierung zuverlässig.

27 Feldtypen

Text, Dateien, Wiederholungsfelder, Farben, Datumsangaben und mehr, definiert in JSON. Auswahlfelder beziehen Einträge aus Beiträgen, Begriffen und Benutzern.

JSON-Schemaüberprüfung

Jede Konfiguration hat ein Schema, das Agents genaue Regeln vorgibt und Fehler sofort erkennt.

Automatische Registrierung

Dateien in ein Verzeichnis legen und Blöcke automatisch registrieren lassen – ganz ohne zusätzliche Konfigurationsliste.

Canvas-Übersicht

Jede verwaltete Seite oder jeder Block mit seinen Standardwerten in einer einzigen zoombaren Ansicht.

Live-Canvas

Der Live-Modus aktualisiert betroffene Artboards etwa eine Sekunde nach dem Speichern über Server-Sent Events. Klicke auf eine Beschriftung, um ein Artboard in den Fokus zu nehmen.

Tailwind integriert

TailwindPHP kompiliert die Klassen, die jede Seite verwendet, ganz ohne Node-Konfiguration.

Element Grabber

Den Vorlagenpfad und das Markup eines Elements kopieren, um einem Agent sofort Kontext zu geben.

HTML zu Blöcken

Seiten und Muster sind einfache Dateien, aus denen native WordPress-Blöcke werden.

Render-Smoke-Test

wp bs blocks render rendert jeden Block wie auf einer Seite und beendet sich mit 1, wenn eine Vorlage einen Hinweis, eine Warnung oder einen Fehler auslöst.

Prüfungen gespeicherter Inhalte

wp bs blocks validate prüft die gespeicherten Felder von Beiträgen, und pages sync warnt vor Attributen, die ein Block speichert, aber nie rendert.

Im Terminal prüfen

Liste Einstellungen, benutzerdefinierte Felder und Assets mit wp bs auf und kompiliere einen Snippet oder eine Datei mit wp bs tailwind compile oder wp bs scss compile.

Plus

Das offizielle Erweiterungspaket

Premium-Websitevorlagen, KI-Systemanweisungen und eine private Discord-Community. Einmaliger Kauf, Updates auf Lebenszeit.

  • 500+ Website-Vorlagen
  • KI-Systemanweisungen
  • Updates auf Lebenszeit
  • Private Discord-Community