Using Superpowers in Laravel Projects
This plugin adds Laravel-aware guidance while staying platform-agnostic. It works in any Laravel app with or without Sail.
Runner Selection (Sail or non-Sail)
Use the minimal wrapper below when running commands:
# 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 SailSee the laravel:runner-selection skill for detection tips, command pairs, and safety notes.
Core Workflows
- Test-Driven Development first: use
laravel:tdd-with-pest - Database changes: use
laravel:migrations-and-factories - Quality gates: use
laravel:quality-checks(Pint, Insights/PHPStan) - Queues and Horizon: use
laravel:queues-and-horizon - Architecture patterns:
laravel:ports-and-adapters,laravel:template-method-and-plugins - Keep complexity low:
laravel:complexity-guardrails
Philosophy
- Favor small, testable services; avoid fat controllers/commands/jobs
- DTOs, typed Collections, and Enums when they clarify intent
- Prefer model factories in tests and model scopes for complex queries
- Verify before completion—run tests and linters clean
Use slash commands as needed:
/superpowers-laravel:brainstorm
/superpowers-laravel:write-plan
/superpowers-laravel:execute-planWhen a Laravel skill exists for your task, use it exactly as written.