| name | laravel-conventions |
| description | Opinionated CORE Laravel 13 + Pest 4 conventions, applied by default on any Laravel project — artisan-first file creation, Eloquent/migration/queue/ scheduler patterns, fail-closed multi-tenancy, parallel-safe tests, and a "verified before done" bar. Composes with (never duplicates) maestro's stack-agnostic discipline. Use when / Trigger: editing or creating anything in a Laravel codebase — models, migrations, factories, jobs, scheduled commands, Filament resources, or Pest tests; whenever you reach for a file generator, design a schema/relationship, write a queued job or a tenant-scoped query, or are about to call a Laravel task "done." |
Laravel Conventions — card index
maestro owns the stack-agnostic discipline (prove-it, scope-discipline,
native-code, finish-your-turn); this skill owns the Laravel-specific defaults
those disciplines apply to. When they overlap, maestro wins on behavior and
this skill supplies the idiom. Don't restate maestro here — apply it.
Anchor versions: Laravel 13, Pest 4, Filament 5, PHP 8.3+.
Every card's code-shaped claims are correct for those versions; if the project
pins older ones (read composer.json), match the project, not this file.
Load exactly ONE card for the topic at hand — never the whole set.
| Card | Load when |
|---|
| artisan-first | any make:* / new-file creation in a Laravel repo |
| migrations | make:migration, edits under database/migrations/ |
| eloquent | edits under app/Models/ |
| queues-scheduler | make:job, edits to routes/console.php, dispatch( |
| tenancy | BelongsToTenant / tenant_id in the diff |
| localization | edits under lang/, __(, ->translateLabel() |
| pest | make:test, edits under tests/ |
| symlinked-packages | edit lands inside a composer.json path-repository dep |
| done-bar | a task is about to be marked done (fires from the verify gate) |
Done is proven by probes and bundle artifacts, never asserted — core probes
L1–L5 in ../../references/conformance-probes.md.
