laravel

このスキルは参照資料へのルーティング用シェルであり、Laravel のプレイブック全体を書き直す場所ではありません。

必須ルール：

1. まず references/stack.md を読み込み、その後、タスクに関連する参照資料のみを読み込みます。
2. バージョン固有の API を適用する前に、composer.json と composer.lock を確認します。新規アプリケーションと明示的なアップグレードでは Laravel 13 を推奨し、既存のアプリケーションを無関係な作業の最中に黙ってアップグレードしてはいけません。
3. コントローラーにビジネスロジックを記述してはいけません。 コントローラーの役割は、バリデーション（Form Request）、委譲（Action）、レスポンスの返却（API Resource）のみです。それ以外は行いません。
4. Eloquent モデルを直接返してはいけません。 すべてのレスポンスで API Resource を経由します。
5. インラインバリデーションを行ってはいけません。 すべてのバリデーションは Form Request クラスに記述します。
6. $guarded = [] は使用しません。 すべてのモデルで明示的に $fillable を指定します。
7. 生のクエリは使用しません。 Eloquent またはパラメーター束縛を使用するクエリビルダーを使います。
8. queue:work を単独で実行してはいけません。 すべてのキュー処理で Horizon を使用します。
9. Model::shouldBeStrict() を AppServiceProvider::boot() で有効にする必要があります。

laravel

入力

• $request：作業対象の Laravel タスク、バグ、機能、またはサブシステム

目標

Laravel の作業を適切なプロジェクト規約に沿って進め、汎用的なフレームワークのデフォルトではなく、既存のバックエンドアーキテクチャに従って実装します。

ステップ 0：スタックの仕様を読む

必ず最初に以下を読みます。

• references/stack.md

この資料に、この Laravel の領域で固定されているランタイム、パッケージ、アーキテクチャの選択が記載されています。

新規アプリケーション、フレームワークのバージョン決定、または Laravel 12 から 13 へのアップグレードの場合は、以下も読みます。

• references/upgrading.md

成功基準：実装を始める前に、プロジェクトの Laravel スタックの選択が明確になっていること。

ステップ 1：関連するリファレンスだけを読み込む

ルーティング表を使って、実際のタスクに合ったリファレンスファイルを選んでください。リファレンスツリー全体をまとめて読み込まないでください。

タスク	読み込むファイル
セッションの開始／スタックの把握	references/stack.md
新規アプリケーション、フレームワークのバージョン選定、Laravel 12 から 13 へのアップグレード	references/upgrading.md
ファイルの作成や変更、フォルダーの規約	references/folder-structure.md
API ルート、バージョニング、ミドルウェア	references/routing.md
コントローラーの作成や編集	references/controller-pattern.md
リクエストへのバリデーション追加	references/form-requests.md
モデル、リレーション、スコープの作成や編集	references/eloquent-models.md
API レスポンスの変換、ページネーション、フィルタリング	references/api-resources.md
ビジネスロジック、Actions、DTO、サービスプロバイダー	references/service-layer.md
認証、トークン、ロール、ポリシー	references/auth.md
マイグレーション、シーダー、ファクトリー、クエリ最適化	references/database.md
エラーレスポンス、例外処理	references/error-handling.md
ロギングの設定、構造化ロギング	references/logging.md
Redis キャッシュ、キャッシュ無効化、TTL 戦略	references/caching.md
ジョブ、キュー、イベント、Horizon、ブロードキャスト	references/queues-jobs.md
テストの作成（機能テストまたはユニットテスト）	references/testing.md
セキュリティ強化、CORS、レート制限、Webhook	references/security.md
API ドキュメントの生成	references/api-docs.md
Telescope、Horizon ダッシュボード、Pulse、ヘルスチェック	references/observability.md
Laravel／Filament の統合境界	references/filament.mdを読み、その後 Filament コードには laravel-filament スキルを使用
Docker のセットアップ、CI/CD、デプロイ	references/docker.md
通知、メール、SMS	references/notifications-mail.md
ファイルのアップロード、S3、メディアライブラリ	references/file-storage.md
タスクスケジューリング、cron ジョブ	references/scheduling.md
AI エージェント、テキスト／画像／音声の生成、エンベディング、RAG	references/ai-sdk.md
AI 支援開発、Boost のセットアップ、ガイドライン、スキル	references/boost.md
MCP サーバー、AI クライアントへのアプリの公開、ツール／リソース／プロンプト	references/mcp.md

複数のタスクがある場合は、複数のファイルを読み込んでください。各リファレンスは単独で参照できる内容になっています。

成功基準：タスクに関連する Laravel の規約だけが適用されています。

ステップ 2：Laravel の基本ガードレールに沿って実装する

次のルールを常に適用してください。

• コントローラーはバリデーションを行い、処理を委譲して、結果を返します
• レスポンスには API リソースを使用します
• 一覧エンドポイントにはページネーションを適用します
• モデルには明示的な $fillable を指定します
• データの変更には適切な Action またはトランザクションパターンを使用します
• キューにはプロジェクトのキューおよび Horizon の規約を使用します

成功基準：フレームワークのデフォルトの近道ではなく、プロジェクトの Laravel アーキテクチャに合った変更になっています。

ステップ 3：必要最小限の関連チェックで検証する

タスクに合った、最小限の検証ループを使用してください。

• PHPUnit または Pest のテスト
• 対象を絞った Artisan またはフレームワークのチェック
• リポジトリのワークフローにすでに含まれている場合は、静的解析またはリンティング
• フレームワークのアップグレードでは、references/upgrading.mdに記載された依存関係とリグレッションのチェック

成功基準：この Laravel プロジェクトで期待される方法で変更が検証されています。

ガードレール

• Laravel のハンドブック全体を SKILL.md にインラインで記載しないでください。
• references/stack.mdを省略しないでください。
• Eloquent モデルをそのまま返さないでください。
• ビジネスロジックをコントローラーに記述しないでください。
• タスクにアップグレードが含まれない限り、Laravel 12 プロジェクトに Laravel 13 専用の API を適用しないでください。
• 現在の Laravel パッチリリースを固定しないでください。サポートされている ^13.0 制約とロックファイルを使用してください。
• disable-model-invocation を追加しないでください。これは通常のドメインスキルです。

リファレンスを読み込むタイミング

• references/stack.md 常に読み込みます。

• 次に、references/内のタスクに関連するファイルだけを読み込みます

出力契約

以下を報告してください。

1. 検出された Laravel のメジャーバージョンと、Laravel 13 が推奨されたか、すでに使用されていたか
2. 読み込まれた Laravel のリファレンス
3. 選択されたアーキテクチャパターン
4. 行った変更
5. 実施した検証