laravel-boost

Laravel Boost

概要

Laravel Boost は、合成可能なガイドライン、必要に応じて利用できるエージェントスキル、MCP（Model Context Protocol）サーバー、そして 17,000 件を超える Laravel 固有のナレッジを対象としたセマンティック検索機能付きドキュメント API を提供し、AI を活用した開発を加速する公式 Laravel パッケージです。AI コーディングツールと Laravel エコシステムをつなぎ、AI エージェントが高品質で規約に準拠した Laravel コードを生成できるようにします。

プロジェクトで Laravel Boost をセットアップ、設定、拡張する場合や、AI エージェントを Laravel アプリケーションと連携させる場合に、このスキルを適用してください。

複数フェーズのプロセス

フェーズ 1：評価

1. Laravel のバージョンとの互換性（10.x、11.x、12.x）を確認します
2. 使用する AI IDE またはエージェント（Cursor、Claude Code、Codex、Gemini CLI、GitHub Copilot、Junie）を特定します
3. MCP 設定（.mcp.json）がすでに存在するか確認します
4. .ai/ 内の既存のガイドラインとスキルのカスタマイズ内容を確認します

STOP — Laravel のバージョンとの互換性と対象 IDE を確認する前に、Boost をインストールしないでください。

フェーズ 2：インストールと設定

1. パッケージをインストールし、インストーラーを実行します
2. 対象 IDE 用の MCP サーバーを設定します
3. Composer フックを使った自動更新をセットアップします
4. AI エージェントから MCP ツールにアクセスできることを確認します

STOP — 少なくとも 1 回ツールを呼び出して MCP サーバーへの接続を確認するまで、先に進まないでください。

フェーズ 3：カスタマイズ

1. プロジェクト固有のガイドラインを .ai/guidelines/ に追加します
2. ドメイン固有のスキルを .ai/skills/ に作成します
3. プロジェクトの規約が組み込みのガイドラインやスキルと異なる場合は、それらをオーバーライドします
4. サポート対象外の IDE に拡張する場合は、カスタムエージェントを登録します

STOP — プロジェクトの規約が Laravel のデフォルトと実際に異なる場合を除き、組み込みのガイドラインをオーバーライドしないでください。

フェーズ 4：検証

1. MCP サーバーがツール呼び出し（アプリケーション情報、データベーススキーマ、ドキュメント検索）に応答することを確認します
2. AI エージェントのコンテキストウィンドウにガイドラインが読み込まれることを確認します
3. ドメインに関連するタスクでスキルが有効になることをテストします
4. 依存関係の変更後も boost:update によってリソースが最新に保たれることを確認します

IDE セットアップの判断表

IDE / エージェント	セットアップ方法	設定ファイル
Claude Code	CLI コマンド	.mcp.json（自動生成）
Codex	CLI コマンド	.mcp.json
Gemini CLI	CLI コマンド	.mcp.json
Cursor	コマンドパレット GUI	.cursor/mcp.json
GitHub Copilot	コマンドパレット GUI	.mcp.json
Junie	設定 GUI	.mcp.json
カスタム / サポート対象外	カスタムエージェントクラス	MCP 設定を手動で作成

インストール

# Install as a development dependency
composer require laravel/boost --dev

# Run the installer — generates .mcp.json, guideline files, and boost.json
php artisan boost:install

インストーラーによって、次のファイルが生成されます。

• .mcp.json — IDE 連携用の MCP サーバー設定
• ガイドラインファイル（CLAUDE.md、AGENTS.md など）— 検出されたパッケージに合わせて作成
• boost.json — Boost 設定ファイル

IDE ごとの MCP セットアップ

IDE / エージェント	セットアップコマンドまたは操作
Claude Code	claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp
Codex	codex mcp add laravel-boost -- php "artisan" "boost:mcp"
Gemini CLI	gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp
Cursor	コマンドパレット -> 「MCP 設定を開く」-> laravel-boost をオンにします
GitHub Copilot	コマンドパレット -> 「MCP: サーバーを一覧表示」-> laravel-boost を選択 -> 「サーバーを起動」
Junie	Shift-Shift -> 「MCP 設定」-> laravel-boost にチェックを入れる -> 「適用」

MCP の手動設定

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

リソースを最新に保つ

# Manual update after dependency changes
php artisan boost:update

# Automatic updates — add to composer.json scripts
{
    "scripts": {
        "post-update-cmd": [
            "@php artisan boost:update --ansi"
        ]
    }
}

MCP サーバーのツール

Laravel Boost は、MCP サーバーを通じて以下のツールを公開し、AI エージェントがアプリケーションのコンテキストに直接アクセスできるようにします。

ツール	目的	典型的な用途
アプリケーション情報	PHP と Laravel のバージョン、データベースエンジン、エコシステムパッケージ、Eloquent モデルを読み取ります	セッション開始時のコンテキストの把握
データベーススキーマ	データベーススキーマ全体を読み取ります	マイグレーション計画、モデルの生成
データベースクエリ	データベースに対してクエリを実行します	データの確認、デバッグ
データベース接続	利用可能なデータベース接続を確認します	複数データベースの設定
ドキュメント検索	Laravel ドキュメント API 全体を対象にセマンティック検索を行います	ベストプラクティス、API リファレンスの検索
直近のエラー	アプリケーションログの最新のエラーを読み取ります	デバッグワークフロー
ログエントリの読み取り	直近の N 件のログエントリを読み取ります	監視、デバッグ
ブラウザーログ	ブラウザーのログとエラーを読み取ります	フロントエンドのデバッグ
絶対 URL の取得	相対パスの URI を絶対 URL に変換します	リンクの生成

AI ガイドライン

ガイドラインは、AI エージェントのコンテキストにあらかじめ読み込まれる、組み合わせ可能な指示ファイルです。幅広い規約とベストプラクティスを提供します。

利用可能な組み込みガイドライン

パッケージ	対応バージョン
Laravel Framework	Core、10.x、11.x、12.x
Livewire	Core、2.x、3.x、4.x
Flux UI	Core、Free、Pro
Inertia	React、Vue、Svelte（1.x-3.x）
Tailwind CSS	Core、3.x、4.x
Pest	Core、3.x、4.x
PHPUnit、Pint、Sail、Pennant、Volt、Wayfinder、Folio、Herd、MCP	Core

カスタムガイドライン

.ai/guidelines/ に .blade.php または .md ファイルを作成します。

.ai/guidelines/team-conventions.md
.ai/guidelines/billing/stripe-patterns.blade.php

パスを一致させることで、組み込みガイドラインを上書きできます。

.ai/guidelines/inertia-react/2/forms.blade.php

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

パッケージの作者は、次の場所にガイドラインを同梱できます。

resources/boost/guidelines/core.blade.php

エージェントスキル

スキルは、関連する場合にのみ有効化されるオンデマンドの知識モジュールで、コンテキストウィンドウの肥大化を抑えます。

利用可能な組み込みスキル

スキル	分野
livewire-development	Livewire コンポーネントとリアクティビティ
inertia-react-development	React を使用した Inertia.js
inertia-vue-development	Vue を使用した Inertia.js
inertia-svelte-development	Svelte を使用した Inertia.js
pest-testing	Pest のテストパターン
fluxui-development	Flux UI コンポーネント
folio-routing	Folio のページベースのルーティング
tailwindcss-development	Tailwind CSS のユーティリティクラス
volt-development	Volt のシングルファイル Livewire コンポーネント
pennant-development	Pennant の機能フラグ
wayfinder-development	Wayfinder の型安全なルーティング
mcp-development	MCP サーバー／ツールの開発

カスタムスキル

.ai/skills/{skill-name}/SKILL.md を作成します。

---
name: invoice-management
description: Build and work with invoice features including PDF generation and payment tracking.
---

# Invoice Management

## When to use this skill
Use when working with the invoicing module...

ガイドラインとスキルの選択表

質問	ガイドライン	スキル
いつ読み込まれますか？	常に — コンテキストにあらかじめ読み込み	オンデマンド — タスクが一致した場合
適用範囲はどの程度ですか？	基礎となる規約	実装パターンに特化
コンテキストウィンドウへの影響は？	一定（常に存在）	最小限（必要なときだけ読み込み）
何に最適ですか？	コーディング標準、パッケージのバージョン	手順に沿った実装ガイド
内容は頻繁に変わりますか？	まれ（安定した規約）	頻繁（進化するパターン）
チーム全体に適用されますか？	高い（全員が従う）	さまざま（分野固有）

ドキュメント API

Boost は、以下を対象とする 17,000 件以上のドキュメント項目をセマンティック検索できます。

パッケージ	バージョン
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

Search Docs MCP ツールはこの API にクエリを送信します。ガイドラインとスキルは、実装の詳細が必要なときにエージェントがこの API を利用するよう、自動的に指示します。

使用する場合と不要な場合

シナリオ	Laravel Boost を使用しますか？	理由
AI 支援開発を行う Laravel プロジェクト	はい	主なユースケースです
チームで Cursor、Claude Code、Copilot、またはその他の AI IDE を使用している	はい	MCP 統合により出力の品質が向上します
AI が生成するコード全体で一貫した Laravel の規約が必要	はい	ガイドラインによって標準を適用できます
Laravel 以外の PHP プロジェクト	いいえ	Boost は Laravel 専用です
ワークフローで AI コーディングツールを使用していない	いいえ	Boost の価値は AI エージェントとの統合にあります
本番環境での実行時パフォーマンス最適化	いいえ	Boost は開発時専用で、実行時のオプティマイザーではありません
すでに包括的なカスタム AI プロンプトがある	任意	Boost で補完することも、置き換えることもできます

Boost の拡張

カスタムエージェントの登録

標準でサポートされていない AI ツールの場合：

// In AppServiceProvider::boot()
use Laravel\Boost\Boost;

Boost::registerAgent('custom-ide', CustomAgent::class);

カスタムエージェントクラスは Laravel\Boost\Install\Agents\Agent を継承し、関連するインターフェースを実装する必要があります：

• SupportsGuidelines — ガイドラインファイルを生成する場合
• SupportsMcp — MCP サーバーを設定する場合
• SupportsSkills — スキルファイルを生成する場合

アンチパターン／よくある間違い

アンチパターン	問題点	代わりにすること
本番環境にインストールする	Boost は開発時専用で、不要なオーバーヘッドが発生します	composer require --dev を使用します
組み込みのガイドラインをすべて上書きする	Laravel コアチームの推奨事項から乖離します	プロジェクトの実態と異なる場合に限り上書きします
boost:update を無視する	ガイドラインとインストール済みパッケージの同期が崩れます	composer update のたびに実行します
範囲が広すぎるカスタムスキルを作成する	有効化時にコンテキストウィンドウのトークンを無駄にします	各スキルの対象を単一のドメインに絞ります
MCP の検証を省略する	MCP の設定ミスにより、AI エージェントの品質が気付かないうちに低下します	インストール後にツール呼び出しをテストします
.mcp.json をコミットしない	チームメンバー間で AI エージェントの使用体験に差が生じます	バージョン管理にコミットします
ガイドラインとスキルを混在させる	常時読み込まれる内容でコンテキストウィンドウが汚染されます	規約はガイドラインに、パターンはスキルに記述します
アップグレード後にインストーラーを実行しない	新しいガイドラインファイルや MCP ツールが不足します	メジャーアップグレード後に php artisan boost:install を実行します

自己正当化を防ぐための注意点

• 「インストールに成功したから」という理由で MCP の検証を省略しないでください。少なくとも 1 つのツール呼び出しをテストしてください。
• 逸脱について文書化された理由がない限り、組み込みのガイドラインを上書きしないでください。
• 範囲の広いスキルを作成しないでください。複数のドメインを扱う場合は、分割してください。
• Boost を本番環境にインストールしないでください。Boost は --dev 専用の依存関係です。
• 依存関係を変更した後は、忘れずに boost:update を実行してください。古いガイドラインは AI の出力品質を低下させます。

ドキュメントの参照（Context7）

最新のドキュメントを参照するには、mcp__context7__resolve-library-id の後に mcp__context7__query-docs を使用します。返されたドキュメントは、記憶している知識より優先されます。

• laravel/framework — Laravel のコア API、設定、または Artisan コマンドについて
• livewire — コンポーネントのライフサイクル、wire ディレクティブ、または Alpine.js との統合について

---

統合ポイント

スキル	連携方法
laravel-specialist	Boost のガイドラインとスキルにより、AI が生成する Laravel コードの品質が向上します
php-specialist	Boost は、生成されるガイドラインで PHP のバージョンと PSR 標準を尊重します
mcp-builder	Boost の MCP サーバーは MCP パターンの一例です。カスタムツール向けに拡張できます
self-learning	Boost の Application Info ツールは、学習フェーズにプロジェクトのコンテキストを提供します
senior-backend	Boost の Database Schema ツールと Query ツールは、バックエンドのアーキテクチャ上の意思決定を支援します
test-driven-development	Boost の Pest スキルは、AI が生成するテスト向けのテストパターンを提供します

スキルの種類

FLEXIBLE — プロジェクトのニーズに合わせて、プロセスの各フェーズを調整します。新しいプロジェクトでは、インストールと IDE のセットアップを一通り行う必要があります（フェーズ 1〜4）。既存の Boost インストールでは、カスタマイズ（フェーズ 3）または Laravel のアップグレード後の検証（フェーズ 4）だけで済む場合があります。最低限必ず行うことは、MCP サーバーへの接続を確認し、ガイドラインがインストール済みパッケージのバージョンと一致していることを確認することです。