Laravel Boost
- Introduction
- Installation
- MCP Server
- AI Guidelines
- Agent Skills
- Guidelines vs. Skills
- Project Rules
- Documentation API
- Extending Boost
Introduction
Laravel Boost は、AI エージェントが Laravel のベストプラクティスに準拠した高品質の Laravel アプリケーションを作成するのに役立つ重要なガイドラインとエージェント スキルを提供することで、AI 支援開発を加速します。
Boost は、組み込みの MCP ツールと、17,000 を超える Laravel 固有の情報を含む広範なナレッジ ベースを組み合わせた強力な Laravel エコシステム ドキュメント API も提供します。これらはすべて、正確でコンテキストを認識した結果を得るために埋め込みを使用したセマンティック検索機能によって強化されています。 Boost は、Claude Code や Cursor などの AI エージェントに、この API を使用して最新の Laravel 機能とベストプラクティスについて学習するように指示します。
Installation
Laravel Boost は Composer 経由でインストールできます。
composer require laravel/boost --dev
次に、MCP サーバーとコーディング ガイドラインをインストールします。
php artisan boost:install
boost:install コマンドは、インストール プロセス中に選択したコーディング エージェントに関連するエージェント ガイドラインとスキル ファイルを生成します。
Laravel Boost がインストールされたら、Cursor、Claude Code、または選択した AI エージェントを使用してコーディングを開始する準備が整います。
boost:installおよびboost:updateの実行時にこれらのファイルは自動的に再生成されるため、生成された MCP 設定ファイル（.mcp.json）、ガイドラインファイル（CLAUDE.md、AGENTS.md、junie/など）、boost.json設定ファイルをアプリケーションの.gitignoreに自由に追加できます。
Set Up Your Agents
1. Open the command palette (`Cmd+Shift+P` or `Ctrl+Shift+P`)
2. Press `enter` on "/open MCP Settings"
3. Turn the toggle on for `laravel-boost`
Claude Code support is typically enabled automatically. If you find it isn't, open a shell in the project's directory and run the following command:
claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp
Codex support is typically enabled automatically. If you find it isn't, open a shell in the project's directory and run the following command:
codex mcp add laravel-boost -- php "artisan" "boost:mcp"
Gemini CLI support is typically enabled automatically. If you find it isn't, open a shell in the project's directory and run the following command:
gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp
1. Open the command palette (`Cmd+Shift+P` or `Ctrl+Shift+P`)
2. Press `enter` on "MCP: List Servers"
3. Arrow to `laravel-boost` and press `enter`
4. Choose "Start server"
1. Press `shift` twice to open the command palette
2. Search "MCP Settings" and press `enter`
3. Check the box next to `laravel-boost`
4. Click "Apply" at the bottom right
Keeping Boost Resources Updated
ローカルの Boost リソース (AI ガイドラインとスキル) を定期的に更新して、インストールした Laravel エコシステム パッケージの最新バージョンが確実に反映されるようにすることをお勧めします。これを行うには、boost:update Artisan コマンドを使用します。
php artisan boost:update
Composer の「post-update-cmd」スクリプトにこのプロセスを追加することで、このプロセスを自動化することもできます。
{
"scripts": {
"post-update-cmd": [
"@php artisan boost:update --ansi"
]
}
}
デフォルトでは、boost:update コマンドは、アプリケーション内ですでに公開されている既存の Boost リソースのみを更新します。 Boost でアプリケーションをスキャンして新しくインストールされたパッケージを探し、対応するガイドラインとスキルの公開を提案したい場合は、--discover オプションを使用できます。
php artisan boost:update --discover
MCP Server
Laravel Boost は、AI エージェントが Laravel アプリケーションと対話するためのツールを公開する MCP (Model Context Protocol) サーバーを提供します。これらのツールを使用すると、エージェントはアプリケーションの構造の検査、データベースのクエリ、コードの実行などを行うことができます。
Available MCP Tools
| 名前 | 説明 |
|---|---|
| アプリケーション情報 | PHP と Laravel のバージョン、データベースエンジン、バージョン付きエコシステムパッケージの一覧、Eloquent モデルを読み取ります |
| ブラウザログ | ブラウザからログとエラーを読み取ります |
| データベース接続 | デフォルト接続を含む、利用可能なデータベース接続を調査します |
| データベースクエリ | データベースに対してクエリを実行します |
| データベーススキーマ | データベーススキーマを読み取ります |
| 絶対 URL の取得 | 相対パス URI を絶対 URI に変換し、エージェントが有効な URL を生成できるようにします |
| 最後のエラー | アプリケーションのログファイルから最後のエラーを読み取ります |
| ログエントリの読み取り | 最後の N 件のログエントリを読み取ります |
| ルールの記録 | 将来のエージェントが継承できるよう、永続的な project rule を .ai/rules に記録します |
| ドキュメントの検索 | インストール済みパッケージに基づいてドキュメントを取得するため、Laravel がホストするドキュメント API サービスにクエリを実行します |
Manually Registering the MCP Server
場合によっては、選択したエディターに Laravel Boost MCP サーバーを手動で登録する必要がある場合があります。次の詳細を使用して MCP サーバーを登録する必要があります。
| コマンド | php |
| 引数 | artisan boost:mcp |
JSON の例:
{
"mcpServers": {
"laravel-boost": {
"command": "php",
"args": ["artisan", "boost:mcp"]
}
}
}
AI Guidelines
AI ガイドラインは、AI エージェントに Laravel エコシステム パッケージに関する重要なコンテキストを提供するために、事前にロードされる構成可能な命令ファイルです。これらのガイドラインには、エージェントが一貫した高品質のコードを生成するのに役立つ、中心的な規則、ベスト プラクティス、およびフレームワーク固有のパターンが含まれています。
Available AI Guidelines
Laravel Boost には、次のパッケージとフレームワークの AI ガイドラインが含まれています。 core ガイドラインは、すべてのバージョンに適用できる、特定のパッケージに対する AI への一般的なアドバイスを提供します。
| パッケージ | 対応バージョン |
|---|---|
| Core & Boost | core |
| Laravel Framework | core, 10.x, 11.x, 12.x, 13.x |
| Livewire | core, 2.x, 3.x, 4.x |
| Flux UI | core, free, pro |
| Folio | core |
| Herd | core |
| Inertia Laravel | core, 1.x, 2.x, 3.x |
| Inertia React | core, 1.x, 2.x, 3.x |
| Inertia Vue | core, 1.x, 2.x, 3.x |
| Inertia Svelte | core, 1.x, 2.x, 3.x |
| MCP | core |
| Pennant | core |
| Pest | core, 3.x, 4.x |
| PHPUnit | core |
| Pint | core |
| Sail | core |
| Tailwind CSS | core, 3.x, 4.x |
| Livewire Volt | core |
| Wayfinder | core |
| Enforce Tests | conditional |
AI ガイドラインを最新の状態に保つには、Keeping Boost Resources Updated セクションを参照してください。
Adding Custom AI Guidelines
独自のカスタム AI ガイドラインで Laravel Boost を拡張するには、.blade.php または .md ファイルをアプリケーションの .ai/guidelines/* ディレクトリに追加します。これらのファイルは、boost:install を実行すると、Laravel Boost のガイドラインに自動的に組み込まれます。
Overriding Boost AI Guidelines
一致するファイル パスを使用して独自のカスタム ガイドラインを作成することで、Boost の組み込み AI ガイドラインをオーバーライドできます。既存の Boost ガイドライン パスに一致するカスタム ガイドラインを作成すると、Boost は組み込みバージョンの代わりにカスタム バージョンを使用します。
たとえば、Boost の「Inertia React v2 Form Guide」ガイドラインをオーバーライドするには、.ai/guidelines/inertia-react/2/forms.blade.php にファイルを作成します。 boost:install を実行すると、Boost にはデフォルトのガイドラインの代わりにカスタム ガイドラインが含まれます。
Third-Party Package AI Guidelines
サードパーティのパッケージを管理しており、Boost にそのパッケージの AI ガイドラインを含めたい場合は、resources/boost/guidelines/core.blade.php ファイルをパッケージに追加することで実現できます。パッケージのユーザーが php artisan boost:install を実行すると、Boost は自動的にガイドラインをロードします。
AI ガイドラインでは、パッケージが何を行うのかについての簡単な概要を提供し、必要なファイル構造や規則の概要を示し、その主な機能の作成方法や使用方法を (コマンド例やコード スニペットを使用して) 説明する必要があります。 AI がユーザー向けに正しいコードを生成できるように、簡潔で実用的でベスト プラクティスに焦点を当てたものにしてください。以下に例を示します。
## Package Name
This package provides [brief description of functionality].
### Features
- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:
@verbatim
<code-snippet name="How to use Feature 2" lang="php">
$result = PackageName::featureTwo($param1, $param2);
</code-snippet>
@endverbatim
Agent Skills
Agent Skills は、エージェントが特定のドメインで作業するときにオンデマンドでアクティブ化できる軽量の対象を絞ったナレッジ モジュールです。事前に読み込まれるガイドラインとは異なり、スキルを使用すると、関連する場合にのみ詳細なパターンとベスト プラクティスを読み込むことができるため、コンテキストの肥大化が軽減され、AI によって生成されたコードの関連性が向上します。
boost:install を実行して機能としてスキルを選択すると、composer.json で検出されたパッケージに基づいてスキルが自動的にインストールされます。たとえば、プロジェクトに livewire/livewire が含まれている場合、livewire-development スキルが自動的にインストールされます。infer-conventions など Boost に含まれるスキルは、使用しているパッケージに関係なくインストールされます。
Available Skills
| スキル | パッケージ |
|---|---|
| fluxui-development | Flux UI |
| folio-routing | Folio |
| infer-conventions | Boost |
| inertia-react-development | Inertia React |
| inertia-svelte-development | Inertia Svelte |
| inertia-vue-development | Inertia Vue |
| livewire-development | Livewire |
| mcp-development | MCP |
| pennant-development | Pennant |
| pest-testing | Pest |
| tailwindcss-development | Tailwind CSS |
| volt-development | Volt |
| wayfinder-development | Wayfinder |
スキルを最新の状態に保つには、Keeping Boost Resources Updated セクションを参照してください。
Custom Skills
独自のカスタム スキルを作成するには、SKILL.md ファイルをアプリケーションの .ai/skills/{skill-name}/ ディレクトリに追加します。 boost:update を実行すると、カスタム スキルが Boost の組み込みスキルと一緒にインストールされます。
たとえば、アプリケーションのドメイン ロジックのカスタム スキルを作成するには、次のようにします。
.ai/skills/creating-invoices/SKILL.md
Overriding Skills
一致する名前を持つ独自のカスタム スキルを作成することで、Boost の組み込みスキルをオーバーライドできます。既存の Boost スキル名と一致するカスタム スキルを作成すると、Boost は組み込みバージョンの代わりにカスタム バージョンを使用します。
たとえば、Boost の livewire-development スキルをオーバーライドするには、.ai/skills/livewire-development/SKILL.md にファイルを作成します。 boost:update を実行すると、Boost にはデフォルトのスキルの代わりにカスタム スキルが含まれます。
Third-Party Package Skills
サードパーティのパッケージを管理しており、Boost にそのパッケージのスキルを含めたい場合は、resources/boost/skills/{skill-name}/SKILL.md ファイルをパッケージに追加することで実現できます。パッケージのユーザーが php artisan boost:install を実行すると、Boost はユーザーの設定に基づいてスキルを自動的にインストールします。
Boost Skills は Agent Skills format をサポートしており、YAML フロントマッターと Markdown 命令を含む SKILL.md ファイルを含むフォルダーとして構造化する必要があります。 SKILL.md ファイルには、必要なフロントマター (name および description) が含まれている必要があり、オプションでスクリプト、テンプレート、および参考資料を含めることができます。
スキルは、必要なファイル構造または規則の概要を説明し、その主な機能の作成方法または使用方法を (コマンド例またはコード スニペットを使用して) 説明する必要があります。 AI がユーザー向けに正しいコードを生成できるように、簡潔で実用的でベスト プラクティスに焦点を当てたものにしてください。
---
name: package-name-development
description: Build and work with PackageName features, including components and workflows.
---
# Package Name Development
## When to use this skill
Use this skill when working with PackageName features...
## Features
- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:
$result = PackageName::featureTwo($param1, $param2);
Guidelines vs. Skills
Laravel Boost は、AI エージェントにアプリケーションに関するコンテキストを提供する 2 つの異なる方法、ガイドライン と スキルを提供します。
ガイドラインは、AI エージェントの起動時に事前に読み込まれ、コードベース全体に広く適用される Laravel の規則とベスト プラクティスに関する重要なコンテキストを提供します。
スキルは、特定のドメイン (Livewire コンポーネントや Pest テストなど) の詳細なパターンを含む特定のタスクに取り組むときにオンデマンドでアクティブ化されます。関連する場合にのみスキルを読み込むことで、コンテキストの肥大化が軽減され、コードの品質が向上します。
| 観点 | 指針 | スキル |
|---|---|---|
| 読み込み済み | 最初から常に存在 | 必要に応じてオンデマンドで読み込む |
| 範囲 | 広範で基盤となる | 限定的でタスク固有 |
| 目的 | 中核となる規約とベストプラクティス | 詳細な実装パターン |
ガイドラインとスキルはいずれも Laravel エコシステムについて説明しています。アプリケーション固有の規約を反映するには、project rulesを使用してください。
Project Rules
ガイドラインやスキルはエージェントに Laravel のコードの書き方を教えますが、プロジェクトルールはアプリケーションのコードの書き方を教えます。ルールとは、新しいセッションを始めるたびに改めて説明する必要がある事柄です。
- あなたやエージェント、チームメンバーが途中で下した決定。
- エージェントに従わせるのが難しいスタイルガイドや好み。
- 周囲のコードから推測できない落とし穴や制約。
ルールはアプリケーションの .ai/rules ディレクトリ内に Markdown ファイルとして保存し、ソース管理にコミットしてください。エージェント自身のメモリが個人的かつセッション単位であるのに対し、ルールはチームやアプリケーションで作業するすべてのエージェントと共有されます。
各ルールファイルでは、frontmatter 内に適用対象となるファイルの glob を宣言します。
---
paths:
- app/Http/Controllers/**
---
# Http Controllers
## Extend BaseController for tenant scoping
All controllers must extend `App\Http\Controllers\BaseController`, which applies the
current tenant's query scope. Extending Laravel's base controller directly will leak
data across tenants.
さらに、Boost は glob パターンと対応するルールファイルをマッピングした .ai/rules/index.md ファイルも管理しています。エージェントは、ファイルの計画や編集を行う前にこのインデックスを確認するよう指示されているため、関連する場合にのみルールが読み込まれます。
# Project Rules Index
Before planning or editing, find the row whose globs match the file's path and read that rule file.
| Applies to | Rule file |
| --- | --- |
| app/Http/Controllers/** | .ai/rules/controllers.md |
| app/Models/** | .ai/rules/models.md |
.mcp.jsonと生成されたガイドラインファイルとは異なり、チームでルールを共有できるように、.ai/rulesディレクトリはソース管理にコミットしてください。
Recording Rules
ルールを記録するには、エージェントに覚えておくよう依頼するだけです。
Remember that all money values are stored as integer cents, never as floats.
エージェントは、glob、短い title、note を指定して Boost の record-rule MCP ツールを呼び出します。Boost は一致する領域にルールを保存し、必要に応じてルールファイルを作成して、インデックスを更新します。
手作業でルールファイルを作成するのではなく、必ず record-rule ツールを使ってルールを記録してください。Boost はルールの記録時に .ai/rules/index.md を再生成します。エージェントはこのインデックスを使って、作業対象のファイルに適用されるルールを見つけます。手動で追加したルールファイルは、次にインデックスが再生成されるまで検出されません。
Inferring Your Application's Conventions
今後、ルールを1つずつ記録していく方法はうまく機能します。ただし、既存のアプリケーションにはすでに何年にもわたる慣習が蓄積されています。infer-conventions スキルを使うと、これまでに記述したコードからルールを自動的に作成できます。まずは、エージェントにこのスキルを使うよう依頼してください。
Use the infer-conventions skill
このスキルは、バリデーション、コントローラ、認可、モデル、アーキテクチャ、テスト、フロントエンド、データベース、コンソールなど、Laravel の規約に関する項目をチェックリストに沿ってアプリケーション全体から確認します。その後、基底クラス、共有トレイト、モジュール構成などのパターンを対象に、あらかじめ範囲を限定しない確認も行います。
このスキルは、コードがどうあるべきかではなく、実際に何をしているかを記録します。十分な根拠のある、デフォルトではない規約だけを記録し、フレームワークのデフォルトや、Pint または Rector がすでに適用している内容は除外します。また、実際にパターンが混在している場合は、それを規約として記録せずに報告します。ルールを作成する前に、スキルが発見した各規約と、その根拠となる証拠を提示して承認を求めます。確認なしですべての規約を記録させたい場合は、yolo と指示してください。
Disabling Project Rules
プロジェクトルールはデフォルトで有効になっています。完全に無効にするには、次の環境変数を定義してください。これにより、record-rule MCP ツールが削除され、Boost による .ai/rules ディレクトリの管理が停止します。
BOOST_RULES_ENABLED=false
Documentation API
Laravel Boost には、17,000 を超える Laravel 固有の情報を含む広範なナレッジ ベースへのアクセスを AI エージェントに提供するドキュメント API が含まれています。 API は、埋め込みを使用したセマンティック検索を使用して、正確でコンテキストを認識した結果を提供します。
Search Docs MCP ツールを使用すると、エージェントは Laravel でホストされているドキュメント API サービスにクエリを実行し、インストールされているパッケージに基づいてドキュメントを取得できます。 Boost の AI ガイドラインとスキルは、コーディング エージェントにこの API を使用するように自動的に指示します。
| パッケージ | 対応バージョン |
|---|---|
| Laravel Framework | 10.x, 11.x, 12.x, 13.x |
| Filament | 2.x, 3.x, 4.x, 5.x |
| Flux UI | 2.x Free, 2.x Pro |
| Inertia | 1.x, 2.x |
| Livewire | 1.x, 2.x, 3.x, 4.x |
| Nova | 4.x, 5.x |
| Pest | 3.x, 4.x |
| Tailwind CSS | 3.x, 4.x |
Extending Boost
Boost は、多くの人気のある IDE および AI エージェントでそのまま動作します。コーディング ツールがまだサポートされていない場合は、独自のエージェントを作成して Boost と統合できます。
Adding Support for Other IDEs / AI Agents
新しい IDE または AI エージェントのサポートを追加するには、Laravel\Boost\Install\Agents\Agent を拡張するクラスを作成し、必要に応じて次の 1 つ以上のコントラクトを実装します。
Laravel\Boost\Contracts\SupportsGuidelines- AI ガイドラインのサポートを追加します。Laravel\Boost\Contracts\SupportsMcp- MCP のサポートを追加します。Laravel\Boost\Contracts\SupportsSkills- Agent Skills のサポートを追加します。
Writing the Agent
<?php
declare(strict_types=1);
namespace App;
use Laravel\Boost\Contracts\SupportsGuidelines;
use Laravel\Boost\Contracts\SupportsMcp;
use Laravel\Boost\Contracts\SupportsSkills;
use Laravel\Boost\Install\Agents\Agent;
class CustomAgent extends Agent implements SupportsGuidelines, SupportsMcp, SupportsSkills
{
// Your implementation...
}
実装例については、ClaudeCode.php を参照してください。
Registering the Agent
アプリケーションの App\Providers\AppServiceProvider の boot メソッドにカスタム エージェントを登録します。
use Laravel\Boost\Boost;
public function boot(): void
{
Boost::registerAgent('customagent', CustomAgent::class);
}
登録すると、php artisan boost:install を実行するときにエージェントを選択できるようになります。