# KI-native Blockentwicklung

Dateien und kein Buildschritt – genau das liegt Agents.

[Dokumentation lesen](https://blockstudio.dev/de/docs/dev/ai/)

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.

[KI-Integrationsdokumentation](https://blockstudio.dev/de/docs/dev/ai/)

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.

[Projektvertrag](https://blockstudio.dev/de/docs/dev/phpstan/#project-contract-for-coding-agents)

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.

[Analyseprofile](https://blockstudio.dev/de/docs/dev/phpstan/#analysis-presets)

blockstudio.json

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

## [base](https://blockstudio.dev/de/docs/dev/phpstan/#analysis-presets)

Jeder $a-Schlüssel, den eine Vorlage liest, ist in block.json vorhanden; Hooks, Einstellungspfade und Block-Tags sind gültig.

## [theme](https://blockstudio.dev/de/docs/dev/phpstan/#analysis-presets)

Theme-Header, deklarierte Assets, %selector%-Geltungsbereiche, Feldstandards und Grenzen für Wiederholungsfelder.

## [extreme-theme](https://blockstudio.dev/de/docs/dev/phpstan/#analysis-presets)

PHPStan max, escapte Ausgabe, keine Shell-Aufrufe, gültige Tailwind-Klassen und sauberes JavaScript.

## [wordpress-render](https://blockstudio.dev/de/docs/dev/phpstan/#live-wordpress-rendering)

Extreme-Theme plus eine Live-WordPress-Render-Prüfung, die du bereitstellst. Sie läuft ohne Shell, und ein fehlgeschlagener Render wird als Befund erfasst.

## [Twig, Blade und Skripte](https://blockstudio.dev/de/docs/dev/phpstan/#what-it-checks)

Twig, Blade und Block-Tags werden anhand derselben Felder geprüft. Die Extreme-Ebene liest außerdem JavaScript und Interactivity-Direktiven aus deinem Markup und deinen Stores.

## [Bestehende Projekte](https://blockstudio.dev/de/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

Eine PHPStan-Baseline hält erfasste Befunde zurück, während neuer Code das vollständige Preset erfüllt. blockstudioScanRoots liest Blockbibliotheken außerhalb des Stammverzeichnisses ein, und mitgelieferte Stubs typisieren das öffentliche API.

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

[Programmgesteuertes Rendering](https://blockstudio.dev/de/docs/blocks/rendering/#structured-compositions-and-complete-documents)

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

[Plus holen](https://blockstudio.dev/de/plus/)
