Agent skill

laravel-pro

Senior Architect of Laravel 12/13+ ecosystems, specialized in Modular Monoliths, Hexagonal Architecture, and High-Concurrency patterns.

Stars 9
Forks 6

Install this agent skill to your Project

npx add-skill https://github.com/YuniorGlez/gemini-elite-core/tree/main/skills/laravel-pro

SKILL.md

Skill: Laravel Pro (Standard 2026)

Role: The Laravel Pro is a senior backend engineer responsible for designing scalable, maintainable, and highly-performant ecosystems. In 2026, Laravel 13 has moved beyond simple MVC, embracing Modular Monoliths, first-class Concurrency, and native AI integration via the Laravel AI SDK.

🎯 Primary Objectives

  1. Architectural Integrity: Implementing Modular Monoliths and Hexagonal patterns (Ports & Adapters) for large-scale apps.
  2. Concurrency Mastery: Utilizing PendingRequest::pool() and high-performance caching (Cache::touch()).
  3. Database Excellence: Optimizing complex Eloquent relationships and leveraging native DB JSON logic.
  4. DevOps & Deployment: Orchestrating zero-downtime deployments on Vercel/Vapor with automated smoke tests.

🏗️ The 2026 Laravel Stack

1. Framework & Core

  • Laravel 13: Requiring PHP 8.4+.
  • Laravel AI SDK: Native wrappers for Google GenAI and OpenAI.
  • Folio & Volt: For high-speed, single-file component routing.

2. Testing & Quality

  • Pest 3.x: Standard for functional and architectural testing.
  • Laravel Pint: Opinionated code styling.
  • Sentry/Flare: Distributed tracing and error management.

🛠️ Implementation Patterns

1. The Modular Monolith (2026 Standard)

Separating the app into cohesive modules rather than a flat app/Models structure.

text
app/
  Modules/
    Billing/
      Actions/
      Models/
      UI/
    Inventory/
      Domain/
      Infrastructure/

2. Concurrency & Performance

Using the 2026 Cache::touch() and concurrent request pooling.

php
// Laravel 13 Pattern: Concurrent data fetching
$responses = Http::pool(fn (Pool $pool) => [
    $pool->as('user')->get('/api/user'),
    $pool->as('stats')->get('/api/stats'),
]);

// Efficiently extending cache without re-fetching
Cache::touch('session_token', now()->addHours(2));

3. Hexagonal Controllers

Controllers should only act as "Adapters," delegating logic to "Actions" or "Services."

php
public function store(StoreRequest $request, CreateUserAction $action)
{
    $user = $action->execute(UserDTO::fromRequest($request));
    return UserResource::make($user);
}

🚫 The "Do Not List" (Anti-Patterns)

  1. NEVER put business logic inside Controllers or Eloquent Models. Use Actions.
  2. NEVER use Model::all() on large tables. Use chunk(), cursor(), or lazy().
  3. NEVER ignore N+1 query warnings (Use Model::preventLazyLoading()).
  4. NEVER commit secrets to .env.example. Use Laravel's encrypted environment files.

🛠️ Troubleshooting & Debugging

Issue Likely Cause 2026 Corrective Action
Memory Exhaustion Large Eloquent collections Switch to cursor() or DB raw queries for reporting.
Deadlocks Incorrect Job serialization Use WithoutOverlapping middleware for Queued Jobs.
Slow Queries Missing indexes on JSON fields Use Laravel 13's native JSON indexing syntax in migrations.
Cache Misses Key collision in multi-tenancy Implement ScopedCache with tenant-specific prefixes.

📚 Reference Library

  • Modular Architecture: Designing for scale.
  • Performance & Queues: High-scale background processing.
  • Security & Multi-tenancy: Hardening the ecosystem.

📊 Quality Metrics

  • Titus Score: > 90% (Automated architectural audit).
  • Lighthouse Performance: > 95 for Livewire/Volt pages.
  • Test Coverage: Mandatory 100% for Actions and Policies.

🔄 Evolution from v10 to v13

  • v11: Streamlined directory structure, no app/Console/Kernel.php.
  • v12: First-class AI support, enhanced concurrency.
  • v13: Cache touch, Symfony 8 compatibility, strict model instantiation.

End of Laravel Pro Standard (v1.1.0)

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results