superpowers-laravel

Build AI features with the first-party Laravel AI SDK (Laravel 13+); agents, embeddings, images, audio, and tool calling with provider-agnostic APIs

Use API Resources with pagination and conditional fields; keep response shapes stable and cache-friendly

Compose UIs with Blade components, slots, and layouts; keep templates pure and testable

Request effective code reviews—specify focus areas, provide context, ask for architectural feedback, reference Laravel conventions

Practical daily checklist for Laravel projects; bring services up, run migrations, queues, quality gates, and tests

Create effective debugging prompts—include error messages, stack traces, expected vs actual behavior, logs, and attempted solutions

Provide comprehensive context in prompts—files, errors, Laravel version, dependencies, and monorepo details—for accurate AI responses

Define clear relationships and load data efficiently; prevent N+1, use constraints, counts/sums, and pivot syncing safely

Move validation and authorization into Form Requests; use rule objects, custom messages, and nested data handling to keep controllers slim

Use Laravel-specific vocabulary—Eloquent patterns, Form Requests, API resources, jobs/queues—to get idiomatic framework code

Safe database change patterns; when to modify vs add migrations; always pair models with migrations and factories; seeding guidance

Use framework caches and value/query caching to reduce work; add tags, locks, and explicit invalidation strategies for correctness

Use first-party PHP attributes (Laravel 13+) for controllers, authorization, queue jobs, and models; declarative configuration colocated with code

Enforce access via Policies and Gates; use authorize() and authorizeResource() to standardize controller protections

Operate and verify queues with or without Horizon; safe worker flags, failure handling, and test strategies

Configure CSRF and origin-aware request forgery protection; PreventRequestForgery middleware (Laravel 13+) with token fallback and exclusions

Define clear constraints—performance, security, testing, architecture, dependencies—so AI generates code that meets your project standards

Schedule tasks with safety; use withoutOverlapping, onOneServer, and visibility settings for reliable cron execution

Wrap multi-write operations in transactions; use dispatchAfterCommit and idempotency patterns to ensure consistency

Upgrade an app from Laravel 12.x to 13.x safely; PHP 8.3 baseline, dependency bumps, breaking-change checklist, and verification steps

Add semantic search with native vector queries (Laravel 13+); pgvector similarity clauses, embedding workflows, and hybrid search patterns

Refine AI-generated code through specific feedback—point out errors, identify gaps, show desired changes, reference style guides

Structure prompts for clarity—separate concerns, prioritize requests, specify acceptance criteria, and break work into testable increments

Provide concrete examples—existing code patterns, style samples, input/output pairs—to guide AI toward your project's conventions

Replace hardcoded values with constants, enums, and configuration for maintainability; use PHP 8.1+ enums and config files

Process large datasets efficiently using chunk(), chunkById(), lazy(), and cursor() to reduce memory consumption and improve performance

Write meaningful documentation that explains why not what; focus on complex business logic and self-documenting code

Build with i18n in mind from day one using Laravel translation helpers, JSON files, Blade integration, and locale management

Keep routes clean and focused on mapping requests to controllers; avoid business logic, validation, or database operations in route files

Use reportable/renderable exceptions, structured logs, and channel strategy for observability and graceful failures

Store and serve files via Storage; set visibility, generate URLs, and handle streaming safely

Use the HTTP client with sensible timeouts, retries, and backoff; capture context and handle failures explicitly

Apply per-user and per-route limits with RateLimiter and throttle middleware; use backoffs and headers for clients

Unified quality gates for Laravel projects; Pint, static analysis (PHPStan/Psalm), Insights (optional), and JS linters; Sail and non-Sail pairs provided

Evolve APIs safely using versioned DTOs/transformers, deprecations, and compatibility tests

Detect Sail/non‑Sail and print the right command pairs for your environment; verify dependencies and key services are reachable

Interactive design refinement tailored to Laravel projects; clarify domain, data, interfaces, testing, and quality gates while accounting for Sail/non‑Sail environments

Keep cyclomatic complexity low; flatten control flow, extract helpers, and prefer table-driven/strategy patterns over large switches

Portable storage configuration across S3/R2/MinIO with optional CDN—env toggles, path-style endpoints, and URL generation

Reduce controller bloat using Form Requests for auth/validation, small Actions/Services with DTOs, and resource/single-action controllers