Laravel 向け Claude Code プラグイン集

Tool

概要

Laravel 向けの Claude Code プラグイン群をまとめた小さなコレクションです。中心となる「laravel-simplifier」プラグインは、PHP / Laravel のソースコードを対象に、可読性とメンテナビリティを向上させるための自動的な簡素化処理を行います。具体的には慣習に基づくリファクタリング(命名改善、不要なネストや冗長表現の除去、コメント整理など)を適用し、最近変更された箇所を優先して処理する設計です。リポジトリ自体は軽量で、プラグイン構成やREADMEが含まれており、CIやプルリクエストワークフローへ組み込みやすい形になっています。

GitHub

リポジトリの統計情報

  • スター数: 79
  • フォーク数: 1
  • ウォッチャー数: 79
  • コミット数: 8
  • ファイル数: 3
  • メインの言語: 未指定

主な特徴

  • Laravel のコーディング慣習に沿った自動的なコード簡素化(命名、ネスト削減、可読性向上)
  • 最近変更されたファイルに優先的に適用することでレビュー工数を削減
  • 機能を壊さないことを重視した出力(動作保持を前提とした提案)
  • プラグイン形式で拡張・追加可能、CIやエディタ統合が容易

技術的なポイント

laravel-simplifier は LLM ベースのエージェント(Claude Code 向けプラグイン)として動作する設計を想定しています。技術的には「プロンプト+ルールセット」によるコード変換指示を主体とし、入出力はプレーンなPHPソース、差分、あるいはファイル単位で処理します。主な注目点は以下です。

  1. 慣習適用の自動化: Laravel の慣習(コントローラ・モデルの命名、リクエスト/レスポンス処理のシンプル化、依存注入の推奨など)をルール化しており、不要なユーティリティ関数や過度なネストを排除する提案を行います。これによりレビュー時のスタイル論争を減らす効果が期待できます。

  2. 最近差分重視のワークフロー: 全ファイル処理ではなく、直近のコミットやプルリクエストで変更された箇所を優先して検査・修正案を生成します。これにより自動化コストを抑え、開発サイクルにおけるフィードバック速度を高めます。

  3. 出力の安全性と可検証性: プラグインは「機能を壊さない」ことを優先し、可能であれば変換前後での挙動比較(テストの実行、静的解析ツールの結果比較)を推奨する設計です。直接の実行は行わず、変換案を差分として提示することで開発者が手動で確認して取り込めるよう作られています。

  4. 拡張性とインテグレーション: Claude Code のプラグインフォーマット(.claude-plugin)を利用することで、設定やルール追加が容易です。CI(GitHub Actions 等)やエディタ拡張と連携させることで、プルリク作成時に自動的に提案を生成する運用が可能です。

  5. 制約と注意点: LLM による自動変換は時に誤解を招く変更を提示するため、必ず人間のレビュープロセスを残すべきです。また、セキュリティやパフォーマンスに関わる変更は自動適用せず、テストカバレッジのある箇所でのみ積極的に活用する運用が推奨されます。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .claude-plugin: dir
    • Claude Code プラグインのメタ情報やエントリポイント、プラグインとしての動作設定が置かれている想定ディレクトリです。ここにはプラグイン名、トリガー条件、実行時のプロンプトテンプレートやルールセット定義が含まれることが多く、カスタム設定や複数のサブエージェントを定義できます。
  • README.md: file
    • リポジトリ全体の概要、インストール・利用手順、プラグインごとの説明が記載されています。利用者はここを参照して、Claude Code のランタイムにプラグインを登録する方法や、CI への組み込み方、期待される入出力フォーマットを理解できます。
  • laravel-simplifier: dir
    • 実際の簡素化ロジックやプロンプトテンプレート、サンプル変換のケース、設定ファイルが含まれるディレクトリです。ここには処理対象のスコープ指定(例えばコントローラ、サービスクラス、シード等)や、フィルタリングルール、変換結果の差分生成ルーチンが配置されている想定です。将来的にはルールをYAML/JSONで記述してプラグインの振る舞いを動的に変更できる設計にしやすい構成です。

README の抜粋を見る限り、laravel-simplifier は「明確さ・一貫性・保守性を保ちながら機能を維持する」ことを目的としており、上の構成はその目的に沿ったシンプルな配置になっています。

まとめ

Laravel 向けコード簡素化を狙った軽量プラグイン集。CI 組み込みでレビュー効率化に有用。

リポジトリ情報:

READMEの抜粋:

Laravel Claude Code Plugins

A collection of Claude Code plugins tailored for PHP / Laravel development.

Plugins

laravel-simplifier

A code simplification agent that refines PHP / Laravel code for clarity, consistency, and maintainability while preserving functionality.

Features:

  • Applies common Laravel conventions and standards
  • Reduces unnecessary complexity and nesting
  • Improves readability through clear naming
  • Focuses on recently modified code by default
  • Preserves all…