Laravel Equipo

laravel-equipo

Skill para Claude Code que define una forma segura y consistente de trabajar en proyectos Laravel existentes, especialmente en equipos que mantienen aplicaciones con distintas versiones de PHP, Laravel y arquitecturas.

La skill le indica a Claude que primero reconozca el proyecto, respete sus convenciones, limite el alcance de los cambios y verifique el resultado antes de finalizar.

¿Qué hace?

Antes de modificar un proyecto, Claude revisa:

• La versión de PHP declarada en composer.json.
• La versión y estructura de Laravel.
• La arquitectura existente del proyecto.
• Las convenciones utilizadas por el equipo.
• La configuración local, la base de datos y los servicios externos.
• Los tests y herramientas disponibles.

Durante la implementación aplica criterios para:

• Respetar la arquitectura existente.
• Mantener controladores delgados.
• Utilizar Form Requests para validación.
• Evitar valores y configuraciones hardcodeadas.
• No instalar dependencias sin autorización.
• No modificar migraciones que ya fueron ejecutadas.
• Prevenir consultas N+1 y cargas masivas.
• Utilizar transacciones cuando se modifican varias tablas relacionadas.
• Evitar comandos destructivos y efectos externos accidentales.
• Mantener los cambios acotados a la solicitud.

Al finalizar, entrega un resumen con:

• Qué se modificó.
• Archivos afectados.
• Cómo probar el cambio.
• Riesgos y supuestos.
• Trabajo pendiente.

Principios principales

1. El proyecto manda sobre las preferencias personales.
2. Lo que no se puede deshacer se consulta antes.
3. Un cambio no está terminado hasta que puede explicarse y probarse.

Estructura

laravel-equipo/
├── SKILL.md
└── references/
    ├── base-de-datos.md
    ├── buenas-practicas.md
    ├── entorno-local.md
    └── versiones.md

Referencias incluidas

• versiones.md: compatibilidad de sintaxis PHP y diferencias entre versiones de Laravel.
• entorno-local.md: controles antes de ejecutar comandos, j