laravel:using-laravel-superpowers

Laravel プロジェクトでの Superpowers の使用

このプラグインは、プラットフォームに依存しないまま、Laravel に特化したガイダンスを追加します。Sail の有無にかかわらず、あらゆる Laravel アプリで動作します。

ランナーの選択（Sail または Sail 以外）

コマンドの実行には、以下の最小限のラッパーを使用してください。

# Prefer Sail if available, else fall back to host
alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'

# Example (both work depending on environment)
sail artisan test           # with Sail
php artisan test            # without Sail
sail composer require x/y   # with Sail
composer require x/y        # without Sail

検出のヒント、コマンドの組み合わせ、安全上の注意については、laravel:runner-selection スキルを参照してください。

主なワークフロー

• まずテスト駆動開発を行います：laravel:tdd-with-pest を使用してください
• データベースの変更：laravel:migrations-and-factories を使用してください
• 品質ゲート：laravel:quality-checks を使用してください（Pint、Insights/PHPStan）
• キューと Horizon：laravel:queues-and-horizon を使用してください
• アーキテクチャパターン：laravel:ports-and-adapters、laravel:template-method-and-plugins
• 複雑さを抑えます：laravel:complexity-guardrails

方針

• 小さくテスト可能なサービスを優先し、肥大化したコントローラー／コマンド／ジョブは避けます
• 意図を明確にできる場合は、DTO、型付きコレクション、Enum を使用します
• テストではモデルファクトリーを、複雑なクエリではモデルスコープを優先します
• 完了前に検証します。テストとリンターを正常に実行してください

必要に応じてスラッシュコマンドを使用してください。

/superpowers-laravel:brainstorm
/superpowers-laravel:write-plan
/superpowers-laravel:execute-plan

タスクに対応する Laravel スキルがある場合は、記載どおりに使用してください。