コンテンツへスキップ

Blockstudioでのバイブコーディング

Andrej Karpathyは2025年2月、AIに作りたいものを説明するとコードを書いてくれるワークフローを「バイブコーディング」と名付けました。それから1年が経ち、この手法は成熟し、現在彼が「エージェント型エンジニアリング」と呼ぶものへと進化しています。開発者がコードを1行ずつ書く代わりに、AIエージェントを統括するスタイルです。

Blockstudioはこの用途を想定して作られました。ファイルベースのアーキテクチャ、ビルドツール不要の設計、予測しやすいプロジェクト構成により、AI支援によるWordPress開発に最適な環境の1つです。

このガイドでは、プロジェクトのセットアップからサイト全体の生成まで、AIコーディングエージェントをBlockstudioと組み合わせるための実践的なパターンを紹介します。

BlockstudioがAIエージェントに適している理由

データベースではなくファイル

AIコーディングエージェントはファイルを読み書きします。それが主な操作方法です。Blockstudioではすべてがファイルシステム内にあります。ブロックごとのblock.jsonとテンプレートファイル、ページごとのpage.json、パターンごとのpattern.jsonです。管理するデータベース項目も、クリックして操作する管理UIも、実行するビルド手順もありません。

ファイルシステムとシェルコマンドは、LLMの事前学習データの中でも特に大きな割合を占めるため、これは重要です。どのモデルも、ファイルの読み書きや整理の例を何百万件も学習しています。WordPressの開発ワークフローをその操作方法に合わせれば、エージェントには最小限の指示で作業させられます。

予測しやすい構成

Blockstudioのブロックはすべて、同じパターンに従います。

コード
my-block/
├── block.json    # Configuration + fields
├── index.php     # Template
└── style.css     # Styles (optional)

この一貫性により、1つのブロックを作ったエージェントは、同じ要領で100個でも作れます。予想外の動作や例外、隠れた設定はありません。同じパターンはページ(page.json + テンプレート)、パターン(pattern.json + テンプレート)、拡張機能(extend.json)にも適用されます。

ファイルとしてのページ全体

従来のWordPressでページを構築するには、ブロックエディターでブロックをドラッグし、設定を行い、管理画面から保存する必要があります。AIエージェントにはその操作ができません。ファイルが必要です。

Blockstudioのファイルベースのページなら、この問題をすべて解決できます。page.jsonでページのメタデータを定義し、index.phpテンプレートでHTMLを使ってブロック構成を定義します。

コード
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>

エージェントは、コアブロックやカスタムブロック、テンプレートロック、編集コントロールを含むWordPressのページ全体を、2つのファイルを書くだけでひな形から作成できます。wp bs pages syncを実行してソースをWordPressに反映してください。管理画面を開いても、この同期は自動では実行されません。

これはAI支援開発の中でも特に強力な機能の1つです。ページレイアウトを説明してエディターで手作業で組み立てる代わりに、エージェントに伝えるだけでテンプレートを書いてもらえます。成果物はバージョン管理でき、再現可能で、数秒で反復できます。

ビルド手順なし

コンパイル、バンドル、トランスパイルは必要ありません。エージェントがファイルを作成すれば、すぐに動作します。SCSSはサーバー側でコンパイルされます。ES modulesは実行時に解決されます。Tailwind CSSはフロントエンドへのリクエストごとにコンパイルされます。「エージェントがコードを書く」から「ブラウザーでコードが動く」までのフィードバックループは、これ以上ないほど短くなります。

Tailwind CSSが最適な選択肢である理由

Blockstudioは通常のCSSとTailwind CSSの両方をサポートしていますが、AIエージェントを使う場合はTailwindに大きな利点があります。

LLMはTailwindを非常によく知っている

Tailwind CSSは数万ものオープンソースリポジトリで使われています。Claude.ai、Vercel、Shopify、Cursor、OpenAIの自社製品のインターフェースにも採用されています。学習データに広く含まれているため、LLMはTailwindクラスを高い精度で生成でき、存在しないユーティリティをでっち上げることもほとんどありません。

クラスの語彙は有限で、明確に定義されています。エージェントが存在しないCSSのプロパティを作り出すことはできないため、自由形式のCSSで無効なセレクターを生成したり、カスケードの動作を誤解したりする場合と比べて、スタイルのエラーを大幅に減らせます。

スタイルはマークアップ内に記述

Tailwindでは、スタイル情報がすべてHTMLテンプレート内にまとまっています。エージェントは、要素の見た目を完全に把握できる情報を一箇所で確認できます。別々の.cssファイルを参照したり、カスケードの順序を理解したり、詳細度の競合を追跡したりする必要はありません。

テンプレートがすでに1つのファイルになっているBlockstudioブロックでは、特に効果を発揮します。エージェントは、スタイル設定済みのコンポーネント全体を一度に生成できます。

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>

競合せずに複数のエージェントを並行実行

Tailwindのスタイルは各テンプレート内に限定されるため、複数のエージェント(または開発者)が異なるブロックを同時に作業しても、CSSのマージ競合は起きません。あるコンポーネントへの変更が別のコンポーネントを誤って壊すような共有スタイルシートはありません。各ブロックは独立しています。

Blockstudioのスコープ付きスタイル(style.scoped.css)を使えば、通常のCSSでも同様に作業できます。ただしTailwindならCSSファイルが不要になるため、ブロックごとにエージェントが管理するファイルを1つ減らせます。

通常のCSSも引き続き使える

Tailwindは必須ではありません。Blockstudioのアセットパイプラインは.cssファイルと.scssファイルを自動的に処理し、ブロックごとに名前空間が設定されるスコープ付きスタイルにも対応します。別のCSS手法を使うプロジェクトでも、エージェントはその方法で作業できます。Tailwindの利点は、学習データに多く含まれ、スタイルとマークアップが同じ場所にあるため、LLMがより得意としていることです。

AIコーディングエージェント

次のCLIツールは、どれもBlockstudioプロジェクトでそのまま使えます。ファイルの読み書きやシェルコマンドの実行ができ、コンテキストファイルからプロジェクト構成を把握します。

ターミナルエージェント(CLI)

ツール 提供元 備考
Claude Code Anthropic ターミナル中心のエージェント。プロジェクトのコンテキストとしてCLAUDE.mdを読み込みます。
Codex CLI OpenAI Rust製のオープンソースCLI。デスクトップアプリ版もあります。
Gemini CLI Google 100万トークンのコンテキストウィンドウを持つオープンソース。GEMINI.mdを読み込みます。
GitHub Copilot CLI GitHub 調査、タスク、計画、レビューに特化した並列エージェントです。
Aider オープンソース ローカルモデルを含む100以上のLLMプロバイダーに対応しています。
OpenCode オープンソース LSP統合に対応したターミナルTUI。75以上のプロバイダーをサポートしています。
Amazon Q Developer CLI AWS 無料プランがあります。AWS統合プロジェクトに強みがあります。

IDEエージェント

ツール 提供元 備考
Cursor Cursor AIを内蔵したVS Codeのフォーク。CLI(ベータ版)もあります。
Windsurf Cognition AI Cascadeエージェント型アシスタントを搭載したVS Codeのフォークです。
Cline オープンソース 手順ごとに承認できるVS Code拡張機能。CLIもあります。
Kilo Code オープンソース サブエージェントを連携させるオーケストレーターモードがあります。
Continue オープンソース 非同期CI/CDエージェントを備えたVS Code/JetBrains拡張機能です。
Augment Code Augment コードベースの詳細なインデックス化に対応した、エンタープライズ向けツールです。

これらのツールはすべて、Blockstudioプロジェクトのディレクトリ内でファイルを作成、編集できます。特にターミナルエージェントに適しています。Blockstudioの開発はIDE固有の機能を必要とせず、ファイルだけで完結するためです。

AIエージェント向けにプロジェクトを設定する

LLMコンテキストファイル

Blockstudioには、フレームワークのドキュメント全体を索引化したコンテキストファイルがあらかじめ用意されています。要約やチートシートではありません。各ドキュメントのルート、目的、そこで定義される識別子が一度ずつ記載されているため、エージェントは質問に答えるページを見つけ、そのページだけを開けます。ツールがコーパス全体を一度に必要とする場合に備え、すべてのドキュメントとスキーマの全文も別ファイルで利用できます。

blockstudio.jsonで有効にします。

JSON
{
  "ai": {
    "enableContextGeneration": true
  }
}

索引はyour-site.com/blockstudio-llm.txt、全文はyour-site.com/blockstudio-llm-full.txtで利用できるようになります。AIツールに索引を指定すれば、追加の指示がなくてもBlockstudioAPI全体を参照できます。ツールごとの設定方法はAI統合ドキュメントを参照してください。

これにより、フレームワーク固有の指示を自分で書く必要がなくなります。blockstudio-llm.txtを利用できるエージェントは、ブロックの作成、フィールドの定義、テンプレートの記述、Tailwindの設定、ページのセットアップ、Blockstudioが提供するすべてのフックの使い方を調べられます。

プロジェクト固有のコンテキストファイル

多くのAIコーディングエージェントは、コードベース固有の指示を記したプロジェクトレベルのコンテキストファイルも読み込みます。ファイル名の慣例はツールによって異なります。

ファイル ツール
CLAUDE.md Claude Code
AGENTS.md Codex CLI、Gemini CLI、Copilot CLIなど
.cursor/rules/*.mdc Cursor
.github/copilot-instructions.md GitHub Copilot

blockstudio-llm.txtがフレームワークについてすでに説明しているため、プロジェクトのコンテキストファイルには、ディレクトリ構成、命名規則、コマンド、制約など、プロジェクト固有の情報だけを記述すれば十分です。

blockstudio/phpstanをインストールすれば、その説明を手作業で書く必要はありません。vendor/bin/blockstudio-agentsはblockstudio.jsonとプロジェクト内のファイルからAGENTS.mdを生成し、プロジェクトで作成するもの、有効な機能、分析で却下される内容、適用可能なコマンドを記載します。自分が作成していないファイルを上書きせず、再生成時には自分のメモも保持します。

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

AIワークフロー向け開発ツール

Blockstudioには、AI支援開発に特化した開発ツールが2つ含まれています。

キャンバス

Canvasは、Blockstudioのすべてのページを一覧できるFigma風のビューです。ライブiframeのアートボードとして1つの画面に表示されます。トラックパッドでパンし、ピンチまたはCtrl+スクロールでズームできます。

AIエージェントを使う際に役立つのは、タブを切り替えたりWordPress管理画面を移動したりせずに、すべてのページを視覚的に確認できるためです。エージェントがページテンプレートを変更すると、すぐに結果を確認できます。ライブモードを有効にすると、ファイルの変更時にCanvasが自動更新されます。

blockstudio.jsonで有効にします。

JSON
{
  "dev": {
    "canvas": {
      "enabled": true,
      "adminBar": false
    }
  }
}

次に/wp-admin/admin.php?page=blockstudio-canvasへ移動します。ページビュー(全幅のアートボード)とブロックビュー(登録済みブロックをデフォルト値で並べたグリッド)を切り替えられます。

要素取得ツール

Element Grabberは、AIワークフローでよくある問題を解決します。ページ上の特定の要素を描画しているファイルをエージェントに伝えられます。

フロントエンドのURLに?blockstudio-devtoolsを追加し、Cmd+C(Mac)またはCtrl+C(Windows)を100ms押し続けます。十字カーソルのセレクターが起動し、ホバーするとBlockstudioブロックが強調表示されます。要素をクリックすると、そのコンテキストがクリップボードにコピーされます。

コード
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

これをAIコーディングツールに貼り付けると、エージェントはファイルパス、HTMLの構造、対象の要素をすぐに把握できます。テンプレートのファイルパスを手動で調べる必要はありません。

blockstudio.jsonで有効にします。

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}

実践的なパターン

1つのブロックを作る

最も簡単なワークフローは、作りたいものを説明してエージェントに作成させることです。

プロンプト:

引用文(textarea)、著者名(text)、著者の役職(text)、著者の写真(files)のフィールドを持つ推薦コメントブロックを作成してください。スタイルにはTailwindを使ってください。引用文は大きなイタリック体にし、装飾用の引用符を付けてください。

エージェントが作成するもの:

コード
blockstudio/testimonial/
├── block.json
└── index.php

ページ全体を作る

Blockstudioのファイルベースのページを使えば、エージェントがWordPressページ全体をテンプレートとして生成できます。ここで真価を発揮します。ブロックを1つずつ作る代わりに、エージェントが必要なブロックを含むページ構成全体を一度に作成します。

プロンプト:

ヒーローセクション、チームのグリッド、問い合わせフォームのプレースホルダーを含む「About」ページを作成してください。可能な限り既存のブロックを使い、必要に応じて新しいブロックを作ってください。投稿ID 2に割り当ててください。テンプレートをロックしつつ、見出しと段落は編集できるようにしてください。

エージェントが作成するもの:

コード
pages/about/
├── page.json     # postId: 2, templateLock: "all"
└── index.php     # Full block structure with core + custom blocks

参照するカスタムブロック(e.g、blockstudio/team-member/など)も作成します。wp bs pages syncを実行して、テンプレートのロックと編集コントロールを設定したWordPress投稿を作成します。ページ全体がバージョン管理され、再現可能になります。

サイト全体を作る

Blockstudioのアーキテクチャが真価を発揮するのはこの場面です。すべての成果物がファイルなので、1つのプロンプトでサイト全体を生成できます。

プロンプト:

次のページを持つポートフォリオサイトを作ってください:Home、Work、About、Contact。ヒーローセクション、プロジェクトグリッド、プロジェクトカード、チームメンバー、連絡先情報、フッター用のカスタムブロックを作成してください。Tailwindを使ったダークテーマにしてください。カスタムカラーパレットを設定して、blockstudio.jsonでTailwindを構成してください。

エージェントはブロックのディレクトリ、ページテンプレート、Tailwind設定を含むblockstudio.json、必要に応じて再利用可能なセクションのパターンを作成します。すべてが1つの変更セットとしてgitにコミットされます。

エージェントを並行して使うワークフロー

Codexのデスクトップアプリ、GitHub Copilot CLI、Kilo Codeなど、一部のツールでは複数のエージェントを並行実行できます。Blockstudioはブロックごとにファイルが分かれているため、安全に並行作業できます。

  • エージェント1:ヒーローブロックとホームページを作成
  • エージェント2:プロジェクトカードのブロックとWorkページを作成
  • エージェント3:問い合わせフォームのブロックとContactページを作成

各ブロックは独自のディレクトリにあり、Tailwindのスタイルもテンプレート内にまとめられているため、エージェント同士が競合することはありません。共有ファイルはblockstudio.jsonだけで、通常は最初に一度設定すれば十分です。

より良い結果を得るためのヒント

  1. LLMコンテキストファイルを参照する。 フレームワークのドキュメントを参照できると、エージェントが生成するBlockstudioコードの質が大幅に向上します。必ずblockstudio-llm.txtを指定し、プロジェクト自体については生成したAGENTS.mdを渡してください。

  2. フィールドの種類を具体的に指定する。 「画像フィールドを追加して」ではなく、「allowedTypes: ['image']とreturnFormat: 'object'を持つfilesフィールドを追加して」と指定してください。フィールドを正確に定義するほど、必要な修正の回数を減らせます。

  3. まず1つのブロックを作り、そこから広げる。 エージェントにブロックを1つ正しく作らせ、そのパターンを確認してから、同じ規則に従って残りを作るよう依頼します。基準となるブロックを作ると、後続の成果物の質が上がります。

  4. 生成結果を確認する。 バイブコーディングだからといって、コードを無条件に受け入れてよいわけではありません。フィールドの種類が意図どおりか、テンプレートが正しく描画されるか、Tailwindクラスが適切な見た目を生み出すかを確認してください。AIが生成したコードは、公開前にレビューしましょう。

  5. block.jsonスキーマを使う。 Blockstudioはhttps://blockstudio.dev/schema/blockにJSON Schemaを提供しています。block.jsonに"$schema"を追加すると、エージェントに検証結果が伝わり、不正な設定を防げます。

  6. ブロックは小さく、役割を絞る。 見た目のコンポーネントごとにブロックを1つ作ります。各ブロックについてエージェントが推論しやすくなり、テンプレートをコンテキストウィンドウの1回分に収まる長さに保てます。