コンテンツへスキップ

AIネイティブなブロック開発

ファイルを使い、ビルド工程もありません。エージェントが得意とする方法です。

コーディングエージェントが、1つのプロンプトから10個のカスタムブロックと6ページを使ってWordPressサイトを完成させる、無音の画面録画です。

ブロックを説明すれば、ブロックができる

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

プロジェクトの契約

ドキュメントはBlockstudioについて説明します。AGENTS.mdはエージェントが変更するプロジェクトについて説明します。

1つのコマンドでAGENTS.mdを作成

vendor/bin/blockstudio-agentsは実行対象のプロジェクトを説明します。内容、有効な機能blockstudio.json、分析で却下される条件、使用できるコマンドが記載されます。

すべての行はファイル、設定、または選択した分析プリセットに基づきます。再生成しても手書きのメモは保持され、契約が古い場合は--checkが失敗します。

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.

コミット前に間違いを検出

4つの解析プリセットはそれぞれ前のものを包含し、すべてのコミットで実行するフックも用意されています。

block.jsonを理解した分析

blockstudio/phpstanのプリセットはブロック、ページ、設定を読み取ります。block.jsonで宣言されていないフィールドをテンプレートが読み取る場合や、エスケープせず出力する場合は、分析に失敗します。

テンプレートは、隣にあるblock.jsonから読み込んだ$a型を使います。各フィールド型には具体的なPHP型があり、Db::get()はdb.phpで定義された形のレコードを返します。設定パスやフック名に誤りがあると、最も近い実在の名前が候補として表示されます。

githooks.commitを設定してvendor/bin/blockstudio-githooks syncを実行すると、管理されたコミット前フックが同じ分析を行い、壊れたブロックがコミットされるのを防ぎます。

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

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()は保存前に格納された属性をチェックします。

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

ページあたりのトークンを半分以下に

エージェントはプレーンなHTMLを記述。Blockstudioが同期時にシリアライズ済みのWordPressブロックマークアップに変換するため、生成量もミスも減ります。

Blockstudio

エージェントが書き出す内容

約135トークン
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

パーサーが生成する内容

約310トークン
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 -->

上の2つのパネルで測定:HTMLは540文字、標準パーサーが生成するブロックマークアップは1,233文字です。通常の1トークンあたりの文字数の目安である4で割って算出しています。マークアップには読みやすいよう改行を加えています。

生成する出力を削減

エージェントはブロック区切り、生成クラス、ラッパーマークアップなしでHTMLを記述できます。

ミスの可能性を低減

パーサーがシンプルな入力から有効なブロック出力を生成します。

より速く、低コストに

出力トークンが少ないほど応答が速くなり、モデルの利用コストも下がります。

あらゆるAIコーディングツールに対応

ファイルを読み書きできるエージェントなら、すぐにBlockstudioを使えます。

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

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でスニペットやファイルをコンパイルできます。

Plus

公式拡張キット

プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。

  • 500+のサイトテンプレート
  • AIシステム向け指示
  • 無期限アップデート
  • 非公開Discordコミュニティ