agent/claude/code/skills/laravel/SKILL.md
Snider fb40da66bd
feat: Add Laravel-specific skill for PHP modules (#64)
Adds a new skill to provide Laravel-specific patterns and guidance for PHP module development.

This includes documentation on:
- Event-driven module structure
- Single-purpose Action classes
- Multi-tenancy with BelongsToWorkspace trait
- UI component conventions (Flux Pro, Font Awesome Pro)
- Common `core` CLI commands for testing, formatting, and analysis.
2026-02-02 07:12:40 +00:00

851 B

name description
laravel Use when working on Laravel code in core-* PHP packages

Laravel Patterns for Host UK

Module Structure

All modules follow event-driven loading via Boot class.

Actions Pattern

Use single-purpose Action classes:

class CreateOrder
{
    use Action;

    public function handle(User $user, array $data): Order
    {
        return Order::create($data);
    }
}
// Usage: CreateOrder::run($user, $validated);

Multi-Tenancy

Always use BelongsToWorkspace trait for tenant-scoped models.

UI Components

  • Use Flux Pro components (not vanilla Alpine)
  • Use Font Awesome Pro (not Heroicons)
  • UK English spellings (colour, organisation)

Commands

core php test              # Run Pest tests
core php fmt --fix         # Format with Pint
core php stan              # PHPStan analysis