laravel-best-practices

Purpose

This skill guides an AI coding agent to:

1. generate Laravel code aligned with established best practices,
2. review Laravel code (or diffs) and propose refactors aligned to those practices,
3. propose and scaffold tests (Pest preferred; PHPUnit supported).

Use when

• Implementing or refactoring controllers, FormRequests, service/action classes, jobs, events/listeners, policies, observers
• Reviewing PRs, diffs, or entire files in a Laravel application
• Designing maintainable application layering and test strategy
• Working on Inertia + React or Inertia + Vue frontends within a Laravel project

Rulebook

Use references/rulebook.json as the source of truth for:

• rule ids
• detection signals
• recommended refactor patterns
• expected outputs