AIネイティブなブロック開発
ファイルを使い、ビルド工程もありません。エージェントが得意とする方法です。
ブロックを説明すれば、ブロックができる
AIコーディングエージェントは、1つのプロンプトからブロック、ページ、パターンを作成できます。GUIもデータベースも不要。ファイルだけで完結します。
~/starter-theme
❯ 3段階の料金プラン、月払い/年払いの切り替え、各プランのCTAを備えた料金ブロックを作成してください。
✓ 作成日時 pricing/block.json
✓ 作成日時 pricing/index.php
✓ 作成日時 pricing/style.css
❯ 次に、ヒーローとFAQセクションを備えた料金ページを作成してください。
✓ 作成日時 pages/pricing/page.json
✓ 作成日時 pages/pricing/index.php
ファイル
blockstudio/
├── pricing/ 新規
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ 新規
├── page.json
└── index.php
すべてをファイルで管理
ブロック、ページ、パターン、拡張機能は、JSON設定とテンプレートを含むディレクトリです。エージェントはそのまま読み書きできます。
データベース設定不要
管理画面を操作する必要はありません。設定はすべてJSONキーなので、エージェントはブラウザーなしでライブラリを生成できます。
予測しやすい構成
すべてのブロックは同じ規約に従います。block.json、テンプレート、必要に応じてスタイル。構成を一度覚えれば使えます。
推測ではなく、コンテキストを
ドキュメントの簡潔なインデックスと、全内容を必要とするツール向けの全文。
エージェントが最初に読むインデックス
blockstudio-llm.txtには、すべてのドキュメントのルート、ソースファイル、目的、管理する設定、フック、PHP関数、CLIコマンドが一度ずつ記載されています。約11kトークンで全体を読み込めるため、エージェントは必要なページだけを開けます。
blockstudio-llm-full.txtにはすべてのドキュメントとJSONスキーマが1ファイルにまとまり、約169kトークンです。全体を必要とするツール向けです。ai.enableContextGenerationを有効にすると、サイトから両方を配信できます。
# 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.プロジェクトの契約
ドキュメントはBlockstudioについて説明します。AGENTS.mdはエージェントが変更するプロジェクトについて説明します。
1つのコマンドでAGENTS.mdを作成
vendor/bin/blockstudio-agentsは実行対象のプロジェクトを説明します。内容、有効な機能blockstudio.json、分析で却下される条件、使用できるコマンドが記載されます。
すべての行はファイル、設定、または選択した分析プリセットに基づきます。再生成しても手書きのメモは保持され、契約が古い場合は--checkが失敗します。
# 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.# Write or refresh the contract
vendor/bin/blockstudio-agents
# Fail CI when it no longer matches the project
vendor/bin/blockstudio-agents --checkコミット前に間違いを検出
4つの解析プリセットはそれぞれ前のものを包含し、すべてのコミットで実行するフックも用意されています。
block.jsonを理解した分析
blockstudio/phpstanのプリセットはブロック、ページ、設定を読み取ります。block.jsonで宣言されていないフィールドをテンプレートが読み取る場合や、エスケープせず出力する場合は、分析に失敗します。
テンプレートは、隣にあるblock.jsonから読み込んだ$a型を使います。各フィールド型には具体的なPHP型があり、Db::get()はdb.phpで定義された形のレコードを返します。設定パスやフック名に誤りがあると、最も近い実在の名前が候補として表示されます。
githooks.commitを設定してvendor/bin/blockstudio-githooks syncを実行すると、管理されたコミット前フックが同じ分析を行い、壊れたブロックがコミットされるのを防ぎます。
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"phpstan": { "preset": "extreme-theme" },
"githooks": { "commit": true }
}$ vendor/bin/blockstudio-githooks sync
$ vendor/bin/blockstudio-phpstan -- --no-progress
Line blockstudio/hero/index.php
3 Dynamic Blockstudio attributes must be escaped before output.
blockstudio.output.unescaped
3 Field "subtitle" does not exist in block.json (block: acme/hero).
blockstudio.fieldbase
テンプレートが読み取る$aキーはすべてblock.jsonに存在します。フック、設定パス、ブロックタグも実在します。
theme
テーマヘッダー、宣言済みアセット、%selector%のスコープ、フィールドの既定値、リピーターの上限・下限。
extreme-theme
PHPStan max、出力のエスケープ、シェル実行なし、有効なTailwindクラス、クリーンなJavaScript。
wordpress-render
Extremeテーマと、用意したライブのWordPressレンダリングプローブ。シェルなしで実行でき、レンダリングに失敗すると問題として報告されます。
Twig、Blade、スクリプト
Twig、Blade、ブロックタグは、同じフィールドに照らしてチェックされます。Extremeレイヤーはさらに、JavaScriptとInteractivityディレクティブをマークアップおよびストアに照らして読み取ります。
既存のプロジェクト
PHPStanベースラインを設定すると、記録済みの問題は保留され、新しいコードにはプリセットの全ルールが適用されます。blockstudioScanRootsでルート外のブロックライブラリを読み込み、同梱スタブで公開APIの型を定義します。
PHPから一覧表示とレンダリング
数回の呼び出しで、エージェントはプロジェクトに登録された内容を確認し、その任意の部分をレンダリングして、保存された内容を調べられます。
プロジェクトに問いかけて回答をレンダリング
Canvas::inventory()は、プロジェクトに登録されたすべてのページ、ブロック、パターン、サイトエディターのテンプレート、テンプレートパーツ、UIの例を、レンダリングせずに返します。
Render::document()はそれらを、使用したアセットだけを含む完全なHTMLドキュメントとしてレンダリングします。エージェントはエディター外で結果を確認できます。
Canvas::documents()は、選択したレコードだけを正確にレンダリングします。Render::composition()とRender::content()は、ネストされた宣言またはシリアライズ済みのブロックコンテンツをHTMLとして返します。Ui::inventory()とUi::examples()では、同梱コンポーネントの各ファミリーから、レンダリング可能な宣言を1つずつ一覧表示します。
1つのブロックについて、bs_block_fields()、bs_block_extension_fields()、bs_block_values()、bs_block_assets()はレンダリングせずにフィールド、値、アセットを返し、bs_validate_block()は保存前に格納された属性をチェックします。
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']);$fields = bs_block_fields('acme/card');
$extended = bs_block_extension_fields('core/paragraph');
$assets = bs_block_assets('acme/card');
$block = parse_blocks($post->post_content)[0];
$a = bs_block_values($block['blockName'], $block['attrs']);
$findings = bs_validate_block($block['blockName'], $block['attrs']);$ wp bs blocks render
$ wp bs blocks render acme/card --attributes='{"variant":"wide"}'
$ wp bs blocks validate 42 57 --format=jsonページあたりのトークンを半分以下に
エージェントはプレーンなHTMLを記述。Blockstudioが同期時にシリアライズ済みのWordPressブロックマークアップに変換するため、生成量もミスも減ります。
Blockstudio
エージェントが書き出す内容
<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
パーサーが生成する内容
<!-- 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 -->上の2つのパネルで測定:HTMLは540文字、標準パーサーが生成するブロックマークアップは1,233文字です。通常の1トークンあたりの文字数の目安である4で割って算出しています。マークアップには読みやすいよう改行を加えています。
生成する出力を削減
エージェントはブロック区切り、生成クラス、ラッパーマークアップなしでHTMLを記述できます。
ミスの可能性を低減
パーサーがシンプルな入力から有効なブロック出力を生成します。
より速く、低コストに
出力トークンが少ないほど応答が速くなり、モデルの利用コストも下がります。
あらゆるAIコーディングツールに対応
ファイルを読み書きできるエージェントなら、すぐにBlockstudioを使えます。
AIワークフロー向けに設計
ブロック、ページ、パターン、設定。すべてがエージェントの読み書きや編集に対応するファイルです。
ブロックごとに2ファイル
JSON設定とテンプレートだけでブロックが完成。構成がシンプルなので、初回の生成も安定します。
27種類のフィールド
テキスト、ファイル、リピーター、色、日付などをJSONで定義。投稿、ターム、ユーザーから選択肢を取得できます。
JSONスキーマ検証
各設定にはスキーマがあり、エージェントに明確なルールを示し、間違いをすぐに検出します。
自動登録
ファイルをディレクトリに置くだけでブロックが自動登録され、設定リストの追加は不要です。
キャンバス全体表示
管理対象のすべてのページ、またはデフォルト値を含むすべてのブロックを、ズーム可能な1つのビューで表示します。
ライブキャンバス
ライブモードでは、保存の約1秒後にServer-Sent Events経由で変更のあったアートボードが更新されます。ラベルをクリックすると、そのアートボードにフォーカスします。
Tailwindを標準搭載
TailwindPHPが各ページで使用するクラスをコンパイル。Nodeの設定は不要です。
Element Grabber
要素のテンプレートパスとマークアップをコピーして、エージェントにすぐコンテキストを渡せます。
HTMLをブロックに変換
ページとパターンは、標準のWordPressブロックになるプレーンテキストファイルです。
レンダリングのスモークテスト
wp bs blocks renderはページと同じ方法ですべてのブロックをレンダリングし、テンプレートで通知、警告、エラーが発生すると1で終了します。
保存済みコンテンツのチェック
wp bs blocks validateは投稿に保存されたフィールドをチェックします。また、pages syncはブロックが保存しているものの一度もレンダリングしない属性を警告します。
ターミナルから確認
wp bsで設定、カスタムフィールド、アセットを一覧表示できます。wp bs tailwind compileまたはwp bs scss compileでスニペットやファイルをコンパイルできます。
公式拡張キット
プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。
- 500+のサイトテンプレート
- AIシステム向け指示
- 無期限アップデート
- 非公開Discordコミュニティ