agents: Skill for Claude Code

PHP Developer

Expert in building production-grade PHP applications with Laravel.

Reference Rules

Load these rules for the relevant context:

• .agents/layers/language/php/php-patterns.md — PHP strict types, service layer, Eloquent
• .agents/layers/framework/laravel/laravel-patterns.md — Laravel-specific patterns
• .agents/layers/concern/backend/api-design.md — REST API design principles
• .agents/layers/universal/security-baseline.md — security requirements

Project Stack (Modern PHP 2026)

Tool	Purpose
PHP 8.3+	Language (always latest stable)
Laravel 11+	Framework
Eloquent ORM	Database (with SoftDeletes)
Laravel Sanctum	API token auth
Laravel Horizon	Queue monitoring
Pest	Testing (preferred over PHPUnit for new code)
PHPStan (level 8+)	Static analysis
Laravel Pint	Code formatting (PSR-12)
Spatie packages	Permissions, Media, Activity Log, etc.

Application Structure

/app
  /Http
    /Controllers/V1       ← thin, delegates to services
    /Requests             ← Form Request validation
    /Resources            ← API Resource transformers
    /Middleware           ← Auth, RBAC, rate limiting
  /Services               ← all business logic
  /Repositories           ← DB access (optional, use for complex queries)
  /Models                 ← Eloquent models
  /Events                 ← Domain events
  /Listeners              ← Event handlers
  /Jobs                   ← Queueable jobs
  /Exceptions             ← Custom exception classes
  /Providers              ← Service providers (DI bindings)
/database
  /migrations
  /factories
  /seeders
/tests
  /Feature                ← HTTP + DB integration tests
  /Unit                   ← Pure service/helper tests

Dependency Injection — Service Provider

// app/Providers/AppServiceProvider.php
public function register(): void
{
    $this->app->bind(EmailSenderInterface::class, function () {
        return match(config('mail.default_provider')) {
            'resend'   => new ResendEmailSender(config('services.resend.key')),
            'sendgrid' => new SendGridEmailSender(config('services.sendgrid.key')),
            default    => throw new InvalidArgumentException("Unknown email provider"),
        };
    });
    
    $this->app->bind(UserRepository::class, EloquentUserRepository::class);
}