Laravel 12.x Laravel Boost

イントロダクションIntroduction

Laravel Boostは、AIエージェントがLaravelのベストプラクティスに従った高品質なLaravelアプリケーションを作成するのを助ける、不可欠なガイドラインとエージェントスキルを提供し、AI支援開発を加速させます。Laravel Boost accelerates AI-assisted development by providing the essential guidelines and agent skills that help AI agents write high-quality Laravel applications that adhere to Laravel best practices.

また、Boostは、17,000件を超えるLaravel固有の情報を含む広範なナレッジベースと、組み込みのMCPツールを組み合わせた、強力なLaravelエコシステムドキュメントAPIを提供します。これらはすべて、正確で文脈を考慮した結果を得るために、埋め込み（embeddings）を使用したセマンティック検索機能によって強化しています。Boostは、Claude CodeやCursorのようなAIエージェントに、このAPIを使用して最新のLaravel機能とベストプラクティスを学習するように指示します。Boost also provides a powerful Laravel ecosystem documentation API that combines a built-in MCP tool with an extensive knowledge base containing over 17,000 pieces of Laravel-specific information, all enhanced by semantic search capabilities using embeddings for precise, context-aware results. Boost instructs AI agents like Claude Code and Cursor to use this API to learn about the latest Laravel features and best practices.

インストールInstallation

Laravel Boostは、Composer経由でインストールできます。Laravel Boost can be installed via Composer:

composer require laravel/boost --dev

次に、MCPサーバとコーディングガイドラインをインストールします。Next, install the MCP server and coding guidelines:

php artisan boost:install

boost:installコマンドは、インストールプロセス中に選択したコーディングエージェントに合わせて、関連するエージェントガイドラインとスキルファイルを生成します。The boost:install command will generate the relevant agent guideline and skill files for the coding agents you selected during the installation process.

Laravel Boostをインストールすれば、CursorやClaude Code、またはお好みのAIエージェントでコーディングを開始する準備は完了です。Once Laravel Boost has been installed, you're ready to start coding with Cursor, Claude Code, or your AI agent of choice.

note Note: 生成されたMCP設定ファイル（.mcp.json）、ガイドラインファイル（CLAUDE.md、AGENTS.md、junie/など）、およびboost.json設定ファイルは、boost:installやboost:updateを実行した際に自動的に再生成されるファイルのため、アプリケーションの.gitignoreに追加するかは、おまかせします。[!NOTE] Feel free to add the generated MCP configuration file (.mcp.json), guideline files (CLAUDE.md, AGENTS.md, junie/, etc.), and the boost.json configuration file to your application's .gitignore, as these files are automatically regenerated when running boost:install and boost:update.

エージェントのセットアップSet Up Your Agents

CursorCursor

1. コマンドパレット（Cmd+Shift+PまたはCtrl+Shift+P）を開きます。Open the command palette (Cmd+Shift+P or Ctrl+Shift+P)
2. 「/open MCP Settings」でenterを押します。Press enter on "/open MCP Settings"
3. laravel-boostのトグルをオンにします。Turn the toggle on for laravel-boost

Claude CodeClaude Code

Claude Codeのサポートは通常、自動的に有効になります。もし有効になっていない場合は、プロジェクトのディレクトリでシェルを開き、以下のコマンドを実行してください。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

CodexCodex

Codexのサポートは通常、自動的に有効になります。もし有効になっていない場合は、プロジェクトのディレクトリでシェルを開き、以下のコマンドを実行してください。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 CLIGemini CLI

Gemini CLIのサポートは通常、自動的に有効になります。もし有効になっていない場合は、プロジェクトのディレクトリでシェルを開き、以下のコマンドを実行してください。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

GitHub Copilot (VS Code)GitHub Copilot (VS Code)

1. コマンドパレット（Cmd+Shift+PまたはCtrl+Shift+P）を開きます。Open the command palette (Cmd+Shift+P or Ctrl+Shift+P)
2. 「MCP: List Servers」でenterを押します。Press enter on "MCP: List Servers"
3. 矢印キーでlaravel-boostに合わせ、enterを押します。Arrow to laravel-boost and press enter
4. 「Start server」を選択します。Choose "Start server"

JunieJunie

1. shiftを2回押してコマンドパレットを開きます。Press shift twice to open the command palette
2. 「MCP Settings」を検索してenterを押します。Search "MCP Settings" and press enter
3. laravel-boostの隣にあるチェックボックスをオンにします。Check the box next to laravel-boost
4. 右下の「Apply」をクリックします。Click "Apply" at the bottom right

Boostリソースの最新保持Keeping Boost Resources Updated

インストールしているLaravelエコシステムパッケージの最新バージョンを確実に反映させるために、ローカルのBoostリソース（AIガイドラインとスキル）を定期的に更新するとよいでしょう。そのためには、boost:update Artisanコマンドを使用します。You may want to periodically update your local Boost resources (AI guidelines and skills) to ensure they reflect the latest versions of the Laravel ecosystem packages you have installed. To do so, you can use the boost:update Artisan command.

php artisan boost:update

また、Composerの"post-update-cmd"スクリプトにこれを追加して、プロセスを自動化することもできます。You may also automate this process by adding it to your Composer "post-update-cmd" scripts:

{
  "scripts": {
    "post-update-cmd": [
      "@php artisan boost:update --ansi"
    ]
  }
}

MCPサーバMCP Server

Laravel Boostは、AIエージェントがLaravelアプリケーションとやり取りするためのツールを公開するMCP（Model Context Protocol）サーバを提供します。これらのツールにより、エージェントはアプリケーションの構造を検査したり、データベースをクエリしたり、コードを実行したりといった能力を得られます。Laravel Boost provides an MCP (Model Context Protocol) server that exposes tools for AI agents to interact with your Laravel application. These tools give agents the ability to inspect your application's structure, query the database, execute code, and more.

利用可能なMCPツールAvailable MCP Tools

MCPサーバの手作業での登録Manually Registering the MCP Server

選択したエディタにLaravel Boost MCPサーバを手作業で登録する必要がある場合があります。以下の詳細を使用してMCPサーバを登録してください。Sometimes you may need to manually register the Laravel Boost MCP server with your editor of choice. You should register the MCP server using the following details:

JSONの例：JSON example:

{
    "mcpServers": {
        "laravel-boost": {
            "command": "php",
            "args": ["artisan", "boost:mcp"]
        }
    }
}

AIガイドラインAI Guidelines

AIガイドラインは、AIエージェントにLaravelエコシステムパッケージに関する不可欠なコンテキストを提供するために、事前にロードされる構成可能な指示ファイルです。これらのガイドラインには、エージェントが一貫性のある高品質なコードを生成するのに役立つ、コアとなる規約、ベストプラクティス、およびフレームワーク固有のパターンが含まれています。AI guidelines are composable instruction files that are loaded upfront to provide AI agents with essential context about Laravel ecosystem packages. These guidelines contain core conventions, best practices, and framework-specific patterns that help agents generate consistent, high-quality code.

利用可能なAIガイドラインAvailable AI Guidelines

Laravel Boostには、以下のパッケージとフレームワーク用のAIガイドラインが含まれています。coreガイドラインは、すべてのバージョンに適用可能な、対象パッケージに対する一般的で汎用的なアドバイスをAIに提供します。Laravel Boost includes AI guidelines for the following packages and frameworks. The core guidelines provide generic, generalized advice to the AI for the given package that is applicable across all versions.

注意： AIガイドラインを最新の状態に保つには、Boostリソースの最新保持セクションを参照してください。Note: To keep your AI guidelines up-to-date, see the Keeping Boost Resources Updated[#keeping-boost-resources-updated] section.

カスタムAIガイドラインの追加Adding Custom AI Guidelines

独自のカスタムAIガイドラインでLaravel Boostを強化するには、アプリケーションの.ai/guidelines/*ディレクトリに.blade.phpまたは.mdファイルを追加してください。これらのファイルは、boost:installを実行した際に、自動的にLaravel Boostのガイドラインへ取り込まれます。To augment Laravel Boost with your own custom AI guidelines, add .blade.php or .md files to your application's .ai/guidelines/* directory. These files will automatically be included with Laravel Boost's guidelines when you run boost:install.

Boost AIガイドラインのオーバーライドOverriding Boost AI Guidelines

一致するファイルパスを持つ独自のカスタムガイドラインを作成することで、Boostに組み込まれるAIガイドラインをオーバーライドできます。既存のBoostガイドラインのパスと一致するカスタムガイドラインを作成すると、Boostは組み込みバージョンの代わりにカスタムバージョンを使用します。You can override Boost's built-in AI guidelines by creating your own custom guidelines with matching file paths. When you create a custom guideline that matches an existing Boost guideline path, Boost will use your custom version instead of the built-in one.

例えば、Boostの「Inertia React v2 Form Guidance」ガイドラインをオーバーライドするには、.ai/guidelines/inertia-react/2/forms.blade.phpにファイルを作成します。boost:installを実行すると、Boostはデフォルトの代わりにカスタムガイドラインを組み込みます。For example, to override Boost's "Inertia React v2 Form Guidance" guidelines, create a file at .ai/guidelines/inertia-react/2/forms.blade.php. When you run boost:install, Boost will include your custom guideline instead of the default one.

サードパーティパッケージのAIガイドラインThird-Party Package AI Guidelines

サードパーティパッケージをメンテナンスしており、BoostにそのためのAIガイドラインを含めたい場合は、パッケージにresources/boost/guidelines/core.blade.phpファイルを追加することで実現できます。パッケージのユーザーがphp artisan boost:installを実行した際、Boostは自動的にあなたのガイドラインをロードします。If you maintain a third-party package and would like Boost to include AI guidelines for it, you can do so by adding a resources/boost/guidelines/core.blade.php file to your package. When users of your package run php artisan boost:install, Boost will automatically load your guidelines.

AIガイドラインでは、パッケージが行うことの短い概要を提供し、必要なファイル構造や規約を概説し、主な機能の作成方法や使用方法を（コマンド例やコードスニペットと共に）説明する必要があります。AIがユーザーに対して正しいコードを生成できるように、簡潔で実用的、かつベストプラクティスに焦点を当てた内容にしてください。以下に例を示します。AI guidelines should provide a short overview of what your package does, outline any required file structure or conventions, and explain how to create or use its main features (with example commands or code snippets). Keep them concise, actionable, and focused on best practices so AI can generate correct code for your users. Here is an example:

## パッケージ名

このパッケージは、[機能の簡単な説明]を提供します。

### 機能

- 機能1：[明確で短い説明]。
- 機能2：[明確で短い説明]。使用例：

@verbatim
<code-snippet name="機能2の使用方法" lang="php">
$result = PackageName::featureTwo($param1, $param2);
</code-snippet>
@verbatim

エージェントスキルAgent Skills

エージェントスキルは、エージェントが特定のドメインで作業する際に、オンデマンドでアクティブ化できる軽量で焦点を絞った知識モジュールです。事前にロードされるガイドラインとは異なり、スキルを使用すると、関連する場合にのみ詳細なパターンやベストプラクティスをロードできるため、コンテキストの肥大化を抑え、AIが生成するコードの関連性を向上させることができます。Agent Skills[https://agentskills.io/home] are lightweight, targeted knowledge modules that agents can activate on-demand when working on specific domains. Unlike guidelines, which are loaded upfront, skills allow detailed patterns and best practices to be loaded only when relevant, reducing context bloat and improving the relevance of AI-generated code.

boost:installを実行して機能としてスキルを選択すると、composer.jsonで検出されたパッケージに基づいてスキルが自動的にインストールされます。例えば、プロジェクトにlivewire/livewireが含まれている場合、livewire-developmentスキルが自動的にインストールされます。When you run boost:install and select skills as a feature, skills are automatically installed based on the packages detected in your composer.json. For example, if your project includes livewire/livewire, the livewire-development skill will be installed automatically.

利用可能なスキルAvailable Skills

注意： スキルを最新の状態に保つには、Boostリソースの最新保持セクションを参照してください。Note: To keep your skills up-to-date, see the Keeping Boost Resources Updated[#keeping-boost-resources-updated] section.

カスタムスキルCustom Skills

独自のカスタムスキルを作成するには、アプリケーションの.ai/skills/{skill-name}/ディレクトリにSKILL.mdファイルを追加してください。boost:updateを実行すると、カスタムスキルがBoostの組み込みスキルと一緒にインストールされます。To create your own custom skills, add a SKILL.md file to your application's .ai/skills/{skill-name}/ directory. When you run boost:update, your custom skills will be installed alongside Boost's built-in skills.

例えば、アプリケーションのドメインロジック用のカスタムスキルを作成する場合です。For example, to create a custom skill for your application's domain logic:

.ai/skills/creating-invoices/SKILL.md

スキルのオーバーライドOverriding Skills

一致する名前を持つ独自のカスタムスキルを作成することにより、Boostに組み込まれたスキルをオーバーライドできます。既存のBoostスキル名と一致するカスタムスキルを作成すると、Boostは組み込みバージョンの代わりにカスタムバージョンを使用します。You can override Boost's built-in skills by creating your own custom skills with matching names. When you create a custom skill that matches an existing Boost skill name, Boost will use your custom version instead of the built-in one.

例えば、Boostのlivewire-developmentスキルをオーバーライドするには、.ai/skills/livewire-development/SKILL.mdにファイルを作成します。boost:updateを実行すると、Boostはデフォルトの代わりにカスタムスキルを組み込みます。For example, to override Boost's livewire-development skill, create a file at .ai/skills/livewire-development/SKILL.md. When you run boost:update, Boost will include your custom skill instead of the default one.

サードパーティパッケージのスキルThird-Party Package Skills

サードパーティパッケージをメンテナンスしており、Boostにそのためのスキルを含めたい場合は、パッケージにresources/boost/skills/{skill-name}/SKILL.mdファイルを追加することで実現できます。パッケージのユーザーがphp artisan boost:installを実行した際、Boostはユーザーの好みに基づいて自動的にあなたのスキルをインストールします。If you maintain a third-party package and would like Boost to include skills for it, you can do so by adding a resources/boost/skills/{skill-name}/SKILL.md file to your package. When users of your package run php artisan boost:install, Boost will automatically install your skills based on user preference.

BoostスキルはAgent Skillsフォーマットをサポートしており、YAMLフロントマターとMarkdown形式の指示を含むSKILL.mdファイルを格納したフォルダとして構成する必要があります。SKILL.mdファイルには必須のフロントマター（nameとdescription）を含める必要があり、オプションでスクリプト、テンプレート、および参照資料を含めることができます。Boost Skills support the Agent Skills format[https://agentskills.io/what-are-skills] and should be structured as a folder containing a SKILL.md file with YAML frontmatter and Markdown instructions. The SKILL.md file must include required frontmatter (name and description) and can optionally include scripts, templates, and reference materials.

スキルでは、必要なファイル構造や規約を概説し、主な機能の作成方法や使用方法を（コマンド例やコードスニペットと共に）説明する必要があります。AIがユーザーに対して正しいコードを生成できるように、簡潔で実用的、かつベストプラクティスに焦点を当てた内容にしてください。Skills should outline any required file structure or conventions, and explain how to create or use its main features (with example commands or code snippets). Keep them concise, actionable, and focused on best practices so AI can generate correct code for your users:

---
name: package-name-development
description: コンポーネントやワークフローを含む、PackageName機能の構築と操作。
---

# パッケージ開発

## このスキルをいつ使うか
PackageNameの機能を操作するときにこのスキルを使用してください...

## 機能

- 機能1：[明確で短い説明]。
- 機能2：[明確で短い説明]。使用例：

$result = PackageName::featureTwo($param1, $param2);

ガイドライン対スキルGuidelines vs. Skills

Laravel Boostは、アプリケーションに関するコンテキストをAIエージェントに提供するための2つの異なる方法、ガイドラインとスキルを提供します。Laravel Boost provides two distinct ways to give AI agents context about your application: guidelines and skills.

ガイドラインはAIエージェントの起動時に事前にロードされ、コードベース全体に広く適用されるLaravelの規約やベストプラクティスに関する不可欠なコンテキストを提供します。Guidelines are loaded upfront when the AI agent starts, providing essential context about Laravel conventions and best practices that apply broadly across your codebase.

スキルは特定のタスクに取り組む際にオンデマンドでアクティブ化され、特定のドメイン（LivewireコンポーネントやPestテストなど）の詳細なパターンを含みます。関連する場合にのみスキルをロードすることで、コンテキストの肥大化を抑え、コードの品質を向上させます。Skills are activated on-demand when working on specific tasks, containing detailed patterns for particular domains (like Livewire components or Pest tests). Loading skills only when relevant reduces context bloat and improves code quality.

ドキュメントAPIDocumentation API

Laravel Boostは、17,000件を超えるLaravel固有の情報を含む広範なナレッジベースへのアクセスをAIエージェントに提供する、ドキュメントAPIを含んでいます。このAPIは、正確で文脈を考慮した結果を提供するために、埋め込みを使用したセマンティック検索を利用しています。Laravel Boost includes a Documentation API that provides AI agents with access to an extensive knowledge base containing over 17,000 pieces of Laravel-specific information. The API uses semantic search with embeddings to deliver precise, context-aware results.

Search Docs MCPツールにより、エージェントはインストール済みパッケージに基づいてドキュメントを取得するために、LaravelがホストするドキュメントAPIサービスを照会できるようにしています。BoostのAIガイドラインとスキルは、このAPIを使用するようコーディングエージェントへ自動的に指示します。The Search Docs MCP tool allows agents to query the Laravel hosted documentation API service to retrieve documentation based on your installed packages. Boost's AI guidelines and skills will automatically instruct your coding agent to use this API.

Boostの拡張Extending Boost

Boostは、多くの一般的なIDEやAIエージェントでそのまま動作します。お使いのコーディングツールがまだサポートされていない場合は、独自のエージェントを作成してBoostと統合できます。Boost works with many popular IDEs and AI agents out of the box. If your coding tool isn't supported yet, you can create your own agent and integrate it with Boost.

他のIDE／AIエージェントへのサポート追加Adding Support for Other IDEs / AI Agents

新しいIDEやAIエージェントのサポートを追加するには、Laravel\Boost\Install\Agents\Agentを継承したクラスを作成し、必要に応じて以下のコントラクトを1つ以上実装してください。To add support for a new IDE or AI agent, create a class that extends Laravel\Boost\Install\Agents\Agent and implement one or more of the following contracts depending on what you need:

• Laravel\Boost\Contracts\SupportsGuidelines - AIガイドラインのサポートを追加します。Laravel\Boost\Contracts\SupportsGuidelines - Adds support for AI guidelines.
• Laravel\Boost\Contracts\SupportsMcp - MCPのサポートを追加します。Laravel\Boost\Contracts\SupportsMcp - Adds support for MCP.
• Laravel\Boost\Contracts\SupportsSkills - エージェントスキルのサポートを追加します。Laravel\Boost\Contracts\SupportsSkills - Adds support for 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
{
    // 実装内容...
}

実装例については、ClaudeCode.phpを参照してください。For an example implementation, see ClaudeCode.php[https://github.com/laravel/boost/blob/main/src/Install/Agents/ClaudeCode.php].

エージェントの登録Registering the Agent

アプリケーションのApp\Providers\AppServiceProviderのbootメソッドで、カスタムエージェントを登録します。Register your custom agent in the boot method of your application's App\Providers\AppServiceProvider:

use Laravel\Boost\Boost;

public function boot(): void
{
    Boost::registerAgent('customagent', CustomAgent::class);
}

登録し終えたら、php artisan boost:installの実行時にエージェントを選択できるようになります。Once registered, your agent will be available for selection when running php artisan boost:install.