メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://kawax.biz/llms.txt

Use this file to discover all available pages before exploring further.

はじめに

Laravel Boostは、AIエージェントが高品質なLaravelアプリケーションをLaravelのベストプラクティスに沿って書けるよう、必要なガイドラインとAgent Skillsを提供することで、AI支援開発を加速させるパッケージです。 Boostはまた、1万7,000件以上のLaravel固有情報を含む知識ベースと、埋め込みを使った意味的検索を組み合わせた強力なLaravelエコシステム ドキュメントAPIを提供します。Boostは、Claude CodeやCursorなどのAIエージェントに対して、このAPIを活用して最新のLaravel機能やベストプラクティスを学ぶよう指示します。

インストール

Laravel BoostはComposerでインストールします。
composer require laravel/boost --dev
次に、MCPサーバーとコーディングガイドラインをインストールします。
php artisan boost:install
boost:install コマンドは、インストール時に選択したコーディングエージェント向けの関連ガイドラインとスキルファイルを生成します。 インストール完了後は、Cursor、Claude Code、またはお好みのAIエージェントを使ってコーディングを始められます。
生成されたMCP設定ファイル(.mcp.json)、ガイドラインファイル(CLAUDE.mdAGENTS.mdjunie/ など)、および boost.json 設定ファイルはアプリケーションの .gitignore に追加しても構いません。これらのファイルは boost:installboost:update を実行する際に自動的に再生成されます。

エージェントの設定

  1. コマンドパレットを開きます(Cmd+Shift+P または Ctrl+Shift+P
  2. “/open MCP Settings” を選択して Enter を押します
  3. laravel-boost のトグルをオンにします

Boostリソースの更新

インストールされているLaravelエコシステムパッケージの最新バージョンを反映させるため、ローカルのBoostリソース(AIガイドラインとスキル)を定期的に更新することをお勧めします。boost:update Artisanコマンドを使用してください。
php artisan boost:update
Composerの post-update-cmd スクリプトに追加して自動化することもできます。
{
  "scripts": {
    "post-update-cmd": [
      "@php artisan boost:update --ansi"
    ]
  }
}
デフォルトでは、boost:update コマンドはアプリケーション内にすでに公開されているBoostリソースのみを更新します。新しくインストールされたパッケージを検出してそのガイドラインやスキルを公開するよう促したい場合は、--discover オプションを使用します。
php artisan boost:update --discover

MCPサーバー

Laravel BoostはMCP(Model Context Protocol)サーバーを提供し、AIエージェントがLaravelアプリケーションと対話するためのツールを公開します。これらのツールにより、エージェントはアプリケーションの構造を調査したり、データベースに問い合わせたり、コードを実行したりすることができます。

利用可能なMCPツール

ツール名説明
Application InfoPHPとLaravelのバージョン、データベースエンジン、バージョン付きエコシステムパッケージ一覧、Eloquentモデルを読み取る
Browser Logsブラウザからのログとエラーを読み取る
Database Connectionsデフォルト接続を含む利用可能なデータベース接続を確認する
Database Queryデータベースに対してクエリを実行する
Database Schemaデータベーススキーマを読み取る
Get Absolute URL相対パスのURIを絶対URLに変換し、エージェントが有効なURLを生成できるようにする
Last Errorアプリケーションのログファイルから最後のエラーを読み取る
Read Log Entries最後のN件のログエントリを読み取る
Search Docsインストール済みパッケージに基づいてLaravelのホスト型ドキュメントAPIサービスに問い合わせる

手動でのMCPサーバー登録

エディタによっては、Laravel Boost MCPサーバーを手動で登録する必要がある場合があります。以下の情報でMCPサーバーを登録してください。
項目
Commandphp
Argsartisan boost:mcp
JSON形式での記述例:
{
    "mcpServers": {
        "laravel-boost": {
            "command": "php",
            "args": ["artisan", "boost:mcp"]
        }
    }
}

AIガイドライン

AIガイドラインは、AIエージェントにLaravelエコシステムパッケージに関する重要なコンテキストを提供するために、あらかじめ読み込まれる命令ファイルです。これらのガイドラインにはコアの規約、ベストプラクティス、フレームワーク固有のパターンが含まれており、エージェントが一貫した高品質なコードを生成するのに役立ちます。

利用可能なガイドライン

Laravel Boostには以下のパッケージとフレームワーク向けのAIガイドラインが含まれています。core ガイドラインは、バージョンに関係なく適用される汎用的なアドバイスを提供します。
パッケージ対応バージョン
Core & Boostcore
Laravel Frameworkcore, 10.x, 11.x, 12.x
Livewirecore, 2.x, 3.x, 4.x
Flux UIcore, free, pro
Foliocore
Herdcore
Inertia Laravelcore, 1.x, 2.x, 3.x
Inertia Reactcore, 1.x, 2.x, 3.x
Inertia Vuecore, 1.x, 2.x, 3.x
Inertia Sveltecore, 1.x, 2.x, 3.x
MCPcore
Pennantcore
Pestcore, 3.x, 4.x
PHPUnitcore
Pintcore
Sailcore
Tailwind CSScore, 3.x, 4.x
Livewire Voltcore
Wayfindercore
Enforce Testsconditional
AIガイドラインを最新の状態に保つには、Boostリソースの更新を参照してください。

カスタムガイドラインの追加

独自のカスタムAIガイドラインをLaravel Boostに追加するには、.blade.php または .md ファイルをアプリケーションの .ai/guidelines/* ディレクトリに追加します。これらのファイルは boost:install を実行する際に、Laravel Boostのガイドラインと自動的に組み合わされます。

Boostのガイドラインをオーバーライドする

ファイルパスが一致するカスタムガイドラインを作成することで、Boostの組み込みガイドラインをオーバーライドできます。既存のBoostガイドラインと一致するパスにカスタムガイドラインを作成すると、Boostは組み込みのガイドラインの代わりにカスタムバージョンを使用します。 たとえば、Boostの “Inertia React v2 Form Guidance” ガイドラインをオーバーライドするには、.ai/guidelines/inertia-react/2/forms.blade.php にファイルを作成します。boost:install を実行すると、Boostはデフォルトのガイドラインの代わりにカスタムガイドラインを使用します。

サードパーティパッケージのガイドライン

サードパーティパッケージを管理しており、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 スキルが自動的にインストールされます。

利用可能なスキル

スキルパッケージ
fluxui-developmentFlux UI
folio-routingFolio
inertia-react-developmentInertia React
inertia-svelte-developmentInertia Svelte
inertia-vue-developmentInertia Vue
livewire-developmentLivewire
mcp-developmentMCP
pennant-developmentPennant
pest-testingPest
tailwindcss-developmentTailwind CSS
volt-developmentVolt
wayfinder-developmentWayfinder
スキルを最新の状態に保つには、Boostリソースの更新を参照してください。

カスタムスキルの作成

独自のカスタムスキルを作成するには、SKILL.md ファイルをアプリケーションの .ai/skills/{skill-name}/ ディレクトリに追加します。boost:update を実行すると、カスタムスキルがBoostの組み込みスキルと一緒にインストールされます。 たとえば、アプリケーション固有のドメインロジック向けのカスタムスキルを作成するには:
.ai/skills/creating-invoices/SKILL.md

スキルのオーバーライド

一致する名前のカスタムスキルを作成することで、Boostの組み込みスキルをオーバーライドできます。既存のBoostスキルと一致する名前でカスタムスキルを作成すると、Boostは組み込みスキルの代わりにカスタムバージョンを使用します。 たとえば、Boostの livewire-development スキルをオーバーライドするには、.ai/skills/livewire-development/SKILL.md にファイルを作成します。boost:update を実行すると、Boostはデフォルトのスキルの代わりにカスタムスキルを使用します。

サードパーティパッケージのスキル

サードパーティパッケージを管理しており、Boostにそのパッケージ向けのスキルを含めたい場合は、パッケージに resources/boost/skills/{skill-name}/SKILL.md ファイルを追加します。パッケージのユーザーが php artisan boost:install を実行すると、Boostはユーザーの希望に応じてスキルを自動的にインストールします。 BoostのスキルはAgent Skillsフォーマットをサポートしており、YAMLフロントマターとMarkdown指示を含む SKILL.md ファイルを格納したフォルダとして構成する必要があります。SKILL.md ファイルには必須フロントマター(namedescription)を含め、スクリプト、テンプレート、参照資料をオプションで含めることができます。
---
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);

ガイドラインとスキルの比較

Laravel Boostは、AIエージェントにアプリケーションに関するコンテキストを提供するための2つの異なる方法を提供します: ガイドラインスキルです。 ガイドラインはAIエージェントの起動時にあらかじめ読み込まれ、コードベース全体に広く適用されるLaravelの規約とベストプラクティスに関する重要なコンテキストを提供します。 スキルは特定のタスクで作業する際にオンデマンドで有効化され、特定のドメイン(LivewireコンポーネントやPestテストなど)の詳細なパターンを含みます。必要な場合にのみスキルを読み込むことで、コンテキストの肥大化を抑えてコード品質を向上させます。
観点ガイドラインスキル
読み込みタイミングあらかじめ、常に存在オンデマンド、関連する場合のみ
スコープ広範囲、基盤的焦点を絞った、タスク固有
目的コアの規約とベストプラクティス詳細な実装パターン

ドキュメントAPI

Laravel Boostには、1万7,000件以上のLaravel固有情報を含む知識ベースへのアクセスをAIエージェントに提供するドキュメントAPIが含まれています。このAPIは埋め込みを使った意味的検索を使用して、精度の高いコンテキスト対応の結果を提供します。 Search Docs MCPツールにより、エージェントはインストール済みパッケージに基づいてLaravelのホスト型ドキュメントAPIサービスに問い合わせることができます。BoostのAIガイドラインとスキルがコーディングエージェントにこのAPIを使用するよう自動的に指示します。
パッケージ対応バージョン
Laravel Framework10.x, 11.x, 12.x
Filament2.x, 3.x, 4.x, 5.x
Flux UI2.x Free, 2.x Pro
Inertia1.x, 2.x
Livewire1.x, 2.x, 3.x, 4.x
Nova4.x, 5.x
Pest3.x, 4.x
Tailwind CSS3.x, 4.x

Boostの拡張

Boostは多くの一般的なIDEやAIエージェントですぐに使えます。お使いのコーディングツールがまだサポートされていない場合は、独自のエージェントを作成してBoostと統合できます。

他のIDE/AIエージェントへの対応追加

新しいIDEやAIエージェントのサポートを追加するには、Laravel\Boost\Install\Agents\Agent を継承するクラスを作成し、必要に応じて以下のコントラクトを1つ以上実装します。
  • Laravel\Boost\Contracts\SupportsGuidelines — AIガイドラインのサポートを追加
  • Laravel\Boost\Contracts\SupportsMcp — MCPのサポートを追加
  • Laravel\Boost\Contracts\SupportsSkills — Agent Skillsのサポートを追加

エージェントの実装

<?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 を参照してください。

エージェントの登録

カスタムエージェントをアプリケーションの App\Providers\AppServiceProviderboot メソッドに登録します。
use Laravel\Boost\Boost;

public function boot(): void
{
    Boost::registerAgent('customagent', CustomAgent::class);
}
登録後、php artisan boost:install を実行する際にエージェントが選択肢として表示されます。
Last modified on March 29, 2026