laravel-patterns

laravel-patterns 概要

laravel-patterns は何のためのものか

laravel-patterns は、Laravel アプリの境界をすっきり整理するための skill です。コントローラは薄く保ち、ビジネスロジックは services や actions に移し、データアクセスは models、scopes、resources を通して予測しやすくします。短期の使い捨てスキャフォールドよりも、保守性が重要な本番 API や Web アプリを作るバックエンドチームに特に向いています。

どんな人が使うべきか

Laravel のコードベースを新規作成またはリファクタリングしていて、routing、Eloquent、queues、events、caching、API responses まで含めた実践的な設計ガイドが欲しいなら、laravel-patterns skill を使う価値があります。Laravel の基礎は理解しているが、成長やチーム引き継ぎを見据えて、よりよい構造にしたい開発者に合っています。コントローラの肥大化を抑えたい場合にも有効です。

インストールする価値がある理由

汎用的なプロンプトと違い、laravel-patterns は Laravel 専用の再利用しやすい思考モデルを与えてくれます。リクエストは HTTP で入り、ルールと認可は早い段階で適用され、ドメイン処理は services/actions でまとめられ、重い処理は jobs やキャッシュ済みの経路に逃がす、という考え方です。つまり、単にアイデアを出すだけでなく、実装方針を揃えたい laravel-patterns for Backend Development に強い skill です。

laravel-patterns の使い方

skill をインストールして読み込む

skills 用のディレクトリツールで laravel-patterns install の手順を実行します。たとえば npx skills add affaan-m/everything-claude-code --skill laravel-patterns のようにします。インストール後は、まず skill のエントリファイルを開き、コードを依頼する前にアーキテクチャのルールに合わせてプロンプトを整えてください。

適切な入力の形で始める

laravel-patterns usage で最も効果が出るのは、feature、route、model、bug など、具体的な対象から始めるやり方です。現在の Laravel バージョン、レイヤーの境界、ほしい結果を伝えてください。よい入力例は次のようなものです。「Laravel 11 で注文エクスポートの流れを設計したい。controller、action、job、resource の各レイヤーを使い、validation は form requests に置く。レポート一覧はキャッシュし、肥大化した controller は避けたい。」

出力品質を左右するファイルを読む

この laravel-patterns guide では、まず SKILL.md とそこからリンクされている example を優先して読みます。次に、変更したい pattern に対応するアプリ側のファイルを確認してください。対象は app/Http/Controllers、app/Actions、app/Services、app/Models、app/Http/Resources、config/* です。リポジトリに別の流儀があるなら、全体に新しい構造を押し付けるのではなく、その conventions に合わせて pattern を調整してください。

実務的なワークフローで使う

よい進め方は、まず feature を説明し、次に architecture plan を依頼し、その後で file ごとに分けた具体的なコードを求める流れです。validation、authorization、query logic、async work、API transformation をどこに置くかを判断させるようにすると、この skill は最も力を発揮します。そこが、通常のプロンプトよりも出力品質を上げやすいポイントです。

laravel-patterns skill の FAQ

laravel-patterns は新規プロジェクト専用ですか？

いいえ。laravel-patterns skill は、controller が重くなりすぎた既存アプリや、実装方針がバラついたコードベースで特に役立ちます。logic を actions に移したり、アプリ全体を書き直さずに resources を追加したりするような、段階的なリファクタリングにも向いています。

通常の Laravel プロンプトと何が違うのですか？

通常のプロンプトでも動くコードは出せますが、laravel-patterns はより強いアーキテクチャの初期値を持っています。routing、Eloquent、queues、events、caching、API resources に関する Laravel の定石を、リクエストごとに場当たり的に決めるのではなく、きちんと守らせたいときに向いています。

初心者でも使えますか？

はい。routes、controllers、models、requests などの基本的な Laravel 概念をすでに理解しているなら問題ありません。ゼロからの入門書のような使い方にはあまり向きません。実際のアプリの中で、その pattern をどこに当てはめるべきかを見分けられる前提があるからです。

使わないほうがよいのはどんなときですか？

小さな使い捨てスクリプト、1 ファイルの試作、Laravel 以外の stack での作業なら laravel-patterns は避けてください。意図的に layered architecture を採らず、これ以上 structure を増やしたくない repo にもあまり適しません。

laravel-patterns skill を改善する方法

事前にアーキテクチャ上の制約を伝える

品質が最も上がるのは、何を thin に保つべきか、何を async にすべきか、何を cache すべきかを最初に明言するときです。Laravel のバージョン、チームの conventions、テストフレームワークに加えて、「新しい packages は追加しない」「既存 routes は維持する」「validation は form requests を使う」といった制約も伝えてください。

コードだけでなく境界を依頼する

よくある失敗は、各責務の置き場を指定せずに feature だけを頼むことです。よりよい laravel-patterns usage では、controller、request、action/service、model scope、job、resource の責務を分けて指定します。そうすると、laravel-patterns for Backend Development にふさわしい、よりきれいな分割を skill が出しやすくなります。

初回案のあとに反復する

最初の回答が一般的すぎる場合は、実際の model 名、relationship、サンプル payload を入れて、より絞った版を依頼してください。最適な laravel-patterns guide の進め方は、まず architecture を詰め、それから file レベルのコードを求め、最後に authorization、pagination、idempotency、queue retry などの edge case を確認する流れです。