Laravel Model Scaffold Skill

Use this skill to create or modify Eloquent Models.

Rules

1. Structure

• Strict Types: Always declare(strict_types=1); .

• Final: Models should be final unless they are explicitly designed for inheritance.

• Fillable: Prefer $fillable over $guarded for explicit security.

2. Modern Casting (Laravel 12)

• Use the casts(): array method (Laravel 11+), NOT the $casts property.

• Use Enums for status columns and native types.

protected function casts(): array { return [ 'status' => TicketStatus::class, 'published_at' => 'datetime', 'is_active' => 'boolean', 'options' => 'array', ]; }

3. Relationships

• Always add return types to relationship methods (BelongsTo , HasMany , etc.).

• Import the relation classes (Illuminate\Database\Eloquent\Relations\BelongsTo ).

public function user(): BelongsTo { return $this->belongsTo(User::class); }

4. Scopes

• Use Builder type hint for scopes.

public function scopeActive(Builder $query): void { $query->where('is_active', true); }