---
description: Laravel application conventions
globs: app/**/*.php
alwaysApply: false
---

- Follow PSR-12 coding standards.
- Use Eloquent ORM; avoid raw SQL unless performance requires it.
- Keep controllers thin; move business logic to Service classes or Actions.
- Use Form Request classes for validation.
- Use API Resources for consistent JSON responses.
- Use route model binding where applicable.
- Queue long-running tasks with Laravel Queues.
- Use migrations for all schema changes; never edit production DB manually.
- Write feature tests for critical user flows.