バージョン: 12.x

Laravel Boost

Introduction
Installation
- Keeping Boost Resources Updated
- Set Up Your Agents
MCP Server
- Available MCP Tools
- Manually Registering the MCP Server
AI Guidelines
Agent Skills
Guidelines vs. Skills
Documentation API
Extending Boost
- Adding Support for Other IDEs / AI Agents

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 エージェントを使用してコーディングを開始する準備が整います。

生成された MCP 構成ファイル (.mcp.json)、ガイドラインファイル (CLAUDE.md、AGENTS.md、junie/ など)、および boost.json 構成ファイルをアプリケーションの .gitignore に自由に追加してください。これらのファイルは、boost:install および boost:update の実行時に自動的に再生成されます。

Set Up Your Agents

Open the command palette (`Cmd+Shift+P` or `Ctrl+Shift+P`)
Press `enter` on "/open MCP Settings"
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

Open the command palette (`Cmd+Shift+P` or `Ctrl+Shift+P`)
Press `enter` on "MCP: List Servers"
Arrow to `laravel-boost` and press `enter`
Choose "Start server"

Press `shift` twice to open the command palette
Search "MCP Settings" and press `enter`
Check the box next to `laravel-boost`
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"
    ]
  }
}

MCP Server

Laravel Boost は、AI エージェントが Laravel アプリケーションと対話するためのツールを公開する MCP (Model Context Protocol) サーバーを提供します。これらのツールを使用すると、エージェントはアプリケーションの構造の検査、データベースのクエリ、コードの実行などを行うことができます。

Available MCP Tools

名前	注意事項
アプリケーション情報	PHP と Laravel のバージョン、データベースエンジン、エコシステムパッケージのバージョンと Eloquent モデルのリストを読む
ブラウザログ	ブラウザからログとエラーを読み取る
データベース接続	デフォルト接続を含む、利用可能なデータベース接続を検査する
データベースクエリ	データベースに対してクエリを実行する
データベーススキーマ	データベーススキーマを読み取る
絶対URLの取得	エージェントが有効な URL を生成できるように、相対パス URI を絶対パスに変換します
最後のエラー	アプリケーションのログファイルから最後のエラーを読み取ります
ログエントリの読み取り	最新の N 個のログエントリを読み取る
ドキュメントの検索	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
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 スキルが自動的にインストールされます。

Available Skills

スキル	パッケージ
fluxui-development	Flux UI
folio-routing	Folio
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 テストなど) の詳細なパターンを含む特定のタスクに取り組むときにオンデマンドでアクティブ化されます。関連する場合にのみスキルを読み込むことで、コンテキストの肥大化が軽減され、コードの品質が向上します。

側面	ガイドライン	スキル
ロード済み	事前に、常に存在する	必要に応じてオンデマンドで
範囲	幅広く、基礎的な	焦点を絞った、特定のタスクに特化した
目的	中心となる規約とベストプラクティス	詳細な実装パターン

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
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 - エージェントスキルのサポートを追加します。

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 を実行するときにエージェントを選択できるようになります。

Introduction​

Installation​

Set Up Your Agents​

Keeping Boost Resources Updated​

MCP Server​

Available MCP Tools​

Manually Registering the MCP Server​

AI Guidelines​

Available AI Guidelines​

Adding Custom AI Guidelines​

Overriding Boost AI Guidelines​

Third-Party Package AI Guidelines​

Agent Skills​

Available Skills​

Custom Skills​

Overriding Skills​

Third-Party Package Skills​

Guidelines vs. Skills​

Documentation API​

Extending Boost​

Adding Support for Other IDEs / AI Agents​

Writing the Agent​

Registering the Agent​

Introduction

Installation

Set Up Your Agents

Keeping Boost Resources Updated

MCP Server

Available MCP Tools

Manually Registering the MCP Server

AI Guidelines

Available AI Guidelines

Adding Custom AI Guidelines

Overriding Boost AI Guidelines

Third-Party Package AI Guidelines

Agent Skills

Available Skills

Custom Skills

Overriding Skills

Third-Party Package Skills

Guidelines vs. Skills

Documentation API

Extending Boost

Adding Support for Other IDEs / AI Agents

Writing the Agent

Registering the Agent