eloquent-models

name	eloquent-models
description	Creates and maintains Eloquent models with strict conventions: column/relation constants, comprehensive class docblock with @property and @property-read sections, foreign keys referenced via constants, and casts/fillable/hidden referencing constants. Use when creating a new model, adding columns or properties to an existing model, adding or modifying relations, or updating model docblocks. Triggers on model, eloquent, relation, belongs to, has many, has one, belongs to many, model constants, model properties, eloquent casts.
metadata	{"boost-tags":"laravel"}

Eloquent Model Development

When to use this skill

Use this skill when:

• Creating a new Eloquent model
• Adding new columns/properties to an existing model
• Adding or modifying relationships on a model
• Updating model constants or docblocks after schema changes

Model Structure

Models follow a strict structure with constants for all column names and relation names, plus a comprehensive class docblock. Inspect the table structure (e.g. via php artisan db:table <table> or a schema introspection helper) when creating or updating models.

Class Docblock

The class docblock is organized into labeled sections. Include only sections that apply.

/**
 * @mixin Eloquent
 *
 * Attributes
 * @property int|null $id
 * @property string|null $name
 * @property int|null $parent_id
 * @property CarbonInterface|null $created_at
 *  CarbonInterface|null $updated_at
 *
 * Appendable attributes
 * -read string $formatted_name
 *
 * Pivots
 * -read PivotModel|null $pivot
 *
 * n:1 relations
 * -read Parent|null $parent
 *
 * 1:n relations
 * -read EloquentCollection<int, ChildModel> $children
 *
 * 1:1 relations
 * -read RelatedModel|null $related
 *
 * n:n relations
 * -read EloquentCollection<int, Tag> $tags
 *
 * Relation counts
 * -read int|null $children_count
 */