Rules de Claude Code para modelos Eloquent y tests con Pest

Hola, bienvenido. En la lección anterior vimos qué son las rules, cómo se limitan a rutas con paths y en qué momento se cargan, y en esta lección vamos a escribir las 2 rules de claude-tasks: una para los modelos de Eloquent y otra para los tests de Pest. Después las vamos a probar con una tarea real, la que dejamos pendiente en la lección de plan mode: el modelo Task, con su migración, su factory, un scope completed y un test que lo cubra. Por el camino vamos a comprobar que las rules entran en el contexto antes de pedir nada, y al terminar tendremos el primer modelo del proyecto, con el circuito de calidad en verde.

¿Por qué justo modelos y tests? Porque son 2 zonas con convenciones propias en las que es fácil romper algo: un modelo con los campos asignables mal declarados o un test que crea los datos a mano pueden pasar el circuito y no seguir las convenciones del resto del proyecto. Y en Laravel 13 hay convenciones recientes que conviene fijar por escrito: si abres app/Models/User.php verás que los campos asignables se declaran con el atributo #[Fillable] y no con una propiedad $fillable, y queremos que el modelo Task siga ese mismo patrón. Una rule es el sitio para decírselo a Claude justo cuando toca un modelo, sin cargarlo en todas las sesiones.

Recuerda también lo que dejamos a medias en la lección Plan mode en Claude Code: revisar antes de ejecutar. Revisamos y corregimos el plan del modelo Task, pero salimos sin aprobarlo porque el proyecto todavía no tenía sus reglas para modelos y tests. Ahora ya tenemos CLAUDE.md, y en esta lección tendremos las rules, así que el plan que salga va a ser distinto, y esta vez sí lo vamos a aprobar.

Para seguir esta lección necesitas claude-tasks con el CLAUDE.md de la lección Cómo escribir un buen CLAUDE.md para un proyecto Laravel en su último commit, los contenedores de Sail levantados y el proyecto con Laravel 13 y Pest 5.2, como lo dejamos al crearlo. Las rules usan paths, que es el único campo que Claude Code lee de una rule. Si quieres ver qué trae de nuevo Pest 5, lo tienes en el artículo Pest 5: el motor Tia, el plugin de agentes y los evals↗ (se abre en una pestaña nueva).

Las 2 rules las vamos a escribir a mano, igual que hicimos con settings.json. Recuerda que .claude es una ruta protegida, así que cualquier escritura de Claude ahí dentro te pide confirmación o pasa por el clasificador, y además son instrucciones del equipo que tienes que conocer al detalle. Empezamos creando la carpeta: