Laravel Superpowers
Laravel-focused skills for Claude Code and AI coding assistants. Brings proven workflows (TDD, debugging, planning) plus Laravel‑specific guidance that works with or without Sail.
What You Get
- Laravel Skills – Runner selection (Sail/non‑Sail), TDD with Pest/PHPUnit, migrations + factories, queues + Horizon, quality gates (Pint/Insights/PHPStan), pragmatic architecture (Ports & Adapters, Template Method), and complexity guardrails.
- Can be used on its own; also compatible with the base Superpowers plugin. Overlapping generic skills are removed here to avoid conflicts.
Plus:
- Slash Commands -
/superpowers-laravel:brainstorm, /superpowers-laravel:write-plan, /superpowers-laravel:execute-plan
- Automatic Integration - Skills activate automatically when relevant
- Consistent Workflows - Systematic approaches to common engineering tasks
SessionStart Preview
Below shows the startup message rendered when this plugin detects Laravel apps. The assistant now supports monorepos and adapts guidance based on which app is active and whether Sail is available.
When Sail is detected - use Sail wrappers
When Sail is NOT detected - use host machine commands
Learn More
Read the introduction to the original Superpowers: Superpowers for Claude Code
Installation
Claude Code (via Plugin Marketplace)
# In Claude Code
/plugin marketplace add jpcaparas/superpowers-laravel
/plugin install superpowers-laravel@superpowers-laravel-marketplace
Verify Installation
# Check that commands appear
/help
# Should see Laravel commands, e.g.:
# /superpowers-laravel:brainstorm
# /superpowers-laravel:write-plan
# /superpowers-laravel:execute-plan
# /superpowers-laravel:laravel-check
# /superpowers-laravel:laravel-tdd
Codex (Experimental)
Codex support is experimental. Use the skills from this repo directly or copy the skills/ subfolders you want into your project’s .claude/skills.
Quick Start
Using Slash Commands
Brainstorm a design (Laravel-specific):
/superpowers-laravel:brainstorm
Create an implementation plan (Laravel-specific):
/superpowers-laravel:write-plan
Execute the plan (Laravel-specific):
/superpowers-laravel:execute-plan
Automatic Skill Activation
Skills activate automatically when relevant. For example:
test-driven-development activates when implementing featuressystematic-debugging activates when debugging issuesverification-before-completion activates before claiming work is done
Runner Guidance (Sail vs host)
- Prefer running commands with Sail when it is available (
vendor/bin/sail or a top‑level ./sail helper); fall back to host tools otherwise.
- When Sail is declared but containers are not running, the assistant will ask whether to start Sail (
sail up -d) or proceed with host tools. It will not run host php/composer/DB/Node commands until you choose.
- When Sail containers are running, use
sail for all PHP/Composer/Node/DB commands to avoid environment drift; do not mix host and container installs in the same session.
- Portable alias:
alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'
Monorepos and Multiple Apps
When multiple Laravel apps exist (for example apps/api, apps/admin), the SessionStart hook:
- Scans the repository recursively (ignores
vendor/, node_modules/, storage/, and VCS/IDE folders) to find every artisan entrypoint.
- Detects Laravel version per app (prefers
composer.lock via jq, falls back to composer.json constraint or a portable parser).
- Shows a summary list of all detected apps with version and Sail availability; marks the app in your current working directory as the “active” app.
- Emits Sail guidance and interactive safety ONLY for the active app.
Tip: cd into the app you intend to work on before starting your session to make it the active app.
What's Inside
Skills Library
Skills live in skills/ and are designed for everyday Laravel work. Core examples include runner-selection, tdd-with-pest, migrations-and-factories, quality-checks, queues-and-horizon, and ports-and-adapters — with many more patterns ready for larger teams.
