laravel-vue-superpowers

Dispatch a Pilot 2.0 Phase-N audit using the active plan-doc's per-phase scope. Reads the active plan, extracts Phase N's audit prompt, dispatches laravel-best-practices in parallel.

Generate a sprint retrospective report from plan-doc + git history + audit reports. Outputs Pilot 2.0 contract compliance per phase, skill-invocation count vs expected, drift instances, test-suite delta, screenshot artifacts list.

Show current sprint state, Pilot 2.0 obligations, hook compliance, and open follow-ups for the active Laravel project. Read-only.

Use in Laravel projects before/during any plan-phase that touches Eloquent models, migrations, queries, or architectural placement (Actions vs Services vs Form Objects vs Controllers). Audits for N+1 queries, missing eager-loading, preventLazyLoading status, migration safety, performance smells, and architectural-pattern drift. Reads existing app/Actions/, app/Services/, app/Http/Requests/, app/Data/ for sibling-canon check — recommends consistency with what's already in the codebase, not generic best practices. Trigger on any plan-phase that touches models, migrations, queries, or layering decisions.

Use in Laravel projects whenever you need to know the current best practice for implementing any feature, pattern, or architectural decision. Does extensive web research across official docs, core team blogs, and trusted community sources (Spatie, Laracasts, Laravel News) to find the most up-to-date 2025/2026 approach. Spawn whenever someone asks: 'how should I implement X?', 'what is the best way to do Y in Laravel?', 'should I use X or Y?', 'is there a package for Z?', 'is my current approach still best practice?'. Also great for validating existing implementation against current standards.

Use in Laravel projects with Echo + Reverb (or Echo + Pusher) when designing any realtime feature, broadcasting event, presence/private channel, or notification fan-out. Default-scans routes/channels.php + app/Notifications/ + existing Echo client callbacks to surface reuse-vs-new-channel decisions BEFORE the brainstorm proposes a redundant broadcast. Catches the canonical 'we already have App.Models.User.{id} broadcasting both forum notifications AND private_message_received — sound playback is pure client-side' insight. Trigger on any 'realtime', 'broadcast', 'Echo', 'Reverb', 'WebSocket', 'live update', 'presence', or 'notification fan-out' work.

Use in Laravel projects using Inertia.js v3 (or v2 in compat mode). Audits Inertia controllers + Vue page components for canonical patterns: Inertia::render data passing, useForm + Precognition form handling, usePage shared-data reactivity, partial reloads with `only:` / `except:`, deferred props (`Inertia::defer()`), modal stack management, history encryption, polling with `usePoll`. Surfaces Inertia v3 specifics (`useHttp`, deferred-prop helpers, history.encrypt) vs v2 patterns. Verifies via reads of `vendor/inertiajs/inertia-laravel/src/` + `node_modules/@inertiajs/vue3/dist/`. Trigger on any Inertia::render controller, useForm/usePage/Link import, or partial-reload usage.

Use in Laravel projects when facing a build-vs-buy decision for any non-trivial feature (file versioning, audit logging, media library, multi-tenancy, search, etc). Given a feature description, searches Packagist + GitHub for 2-5 candidate packages and builds a structured trade-off matrix (license, stars, last-commit, Laravel-version compat, maintenance status, docs quality, test coverage, alternative-build LOC estimate). Recommends best-fit package OR justifies a build-it-yourself decision. Saves brainstorm time + prevents 'we should have used X package' regret 2 weeks in. Trigger on any 'should we use', 'is there a package for', 'build vs use', 'evaluate <package name>' question.

Use in Laravel + Vue 3 + Inertia + Reka UI projects when reviewing accessibility patterns. Covers the 3 patterns that require manual operator work (live region for async ops, reduced-motion query, audio control) — Reka UI primitives handle modal focus, dropdown keyboard nav, form validation announcements, and skip-link automatically. Trigger before merging a feature with custom UI, async operations, animations, or audio.

Use in Laravel projects BEFORE designing or implementing any feature, endpoint, or architectural change. Guides Laravel-specific design decisions: which layer owns the logic, Eloquent relationships, Event/Listener patterns, Policy/Gate design, queuing decisions. In Laravel codebases, invoke this alongside superpowers:brainstorming for the framework-specific layer. ALWAYS trigger when adding new functionality, designing a new endpoint, planning a new model relationship, or choosing between architectural patterns in Laravel.

Use in Laravel projects when completing a feature, reviewing code, or preparing for merge. Checks Laravel-specific concerns: N+1 queries, mass assignment protection, authorization coverage, validation completeness, security, performance. In Laravel codebases, invoke this alongside superpowers:requesting-code-review. Trigger on any 'review', 'check', 'PR', 'done with feature', 'ready to merge' in a Laravel project.

Use in Laravel projects when encountering any bug, test failure, unexpected behavior, N+1 queries, queue issues, or cache problems. Provides Laravel-specific debugging tools and workflows. In Laravel codebases, invoke this instead of superpowers:systematic-debugging. Trigger on any error, 500, unexpected output, slow query, or 'why is X not working' in a Laravel project.

Use in Laravel projects when writing a merge-request / pull-request body at sprint close-out. Generates the canonical MR shape (Summary / Decisions / Pilot 2.0 contract / Spec + Plan link / Test plan with file paths + assertion counts / Scope changes / Deferred items / Follow-up issues / Screenshots) from the project's plan-doc, /laravel-vue-superpowers:status output, and git history. Standardizes the 15-minute manual close-out task. Trigger on 'write MR body', 'PR description', 'sprint close-out', 'ready to merge', or before pushing a feature branch.

22 hooks across 3 events