laravel-tdd
por affaan-mlaravel-tdd es una guía de desarrollo guiado por pruebas en Laravel para PHPUnit y Pest. Ayuda a elegir entre pruebas unitarias, de características e integración, además de la estrategia de base de datos, el uso de fakes, los objetivos de cobertura y un flujo de trabajo práctico para automatizar pruebas.
Esta skill obtiene 84/100 porque ofrece un flujo de trabajo real y utilizable para Laravel TDD, con disparadores claros, guía por capas de prueba y consejos concretos para pruebas de base de datos. Para quienes usan el directorio, merece la pena instalarla si buscan una ayuda con enfoque y opinión para trabajar con pruebas en Laravel, aunque está más centrada en el flujo de trabajo que en la integración con herramientas y no incluye archivos de soporte adicionales.
- Casos de uso claros: se nombran explícitamente nuevas funcionalidades, corrección de errores, refactors y tareas de pruebas en Laravel.
- El flujo operativo es concreto: ciclo red-green-refactor, selección de capas de prueba y guía de estrategia de base de datos reducen las dudas.
- Aporta una ventaja muy específica de Laravel: cubre PHPUnit/Pest, factories, pruebas de base de datos, fakes, objetivos de cobertura y objetivos habituales de Laravel como modelos, políticas, jobs y notificaciones.
- No incluye scripts, referencias ni recursos de apoyo, así que la ejecución depende por completo de las instrucciones de `SKILL.md`.
- El repositorio está marcado con una señal experimental/de prueba, así que conviene verificar si encaja y no esperar un paquete pulido de nivel producción.
Descripción general de la skill laravel-tdd
La skill laravel-tdd es una guía práctica de desarrollo guiado por pruebas en Laravel para escribir primero los tests y después implementar el código con PHPUnit o Pest. Es ideal para desarrolladores que quieren un flujo de trabajo repetible para nuevas funcionalidades, correcciones de errores, refactors y automatización de tests en Laravel, sin improvisar cada vez la estrategia de pruebas.
Lo que hace útil a laravel-tdd es que se centra en decisiones que suelen ralentizar a los equipos: qué capa de test usar, cuándo recurrir a RefreshDatabase, cómo manejar fakes y cómo mantener objetivos de cobertura realistas. Eso hace que la laravel-tdd skill sea más accionable que un prompt genérico de “escribe tests”.
La mejor opción para automatizar tests en Laravel
Usa laravel-tdd cuando necesites automatización de tests para código Laravel que atraviesa HTTP, autenticación, validación, Eloquent, jobs, notificaciones o queues. Encaja especialmente bien si tu proyecto ya valora los ciclos de feedback rápidos y quieres que la skill te ayude a mantener la disciplina del ciclo rojo-verde-refactor.
Qué te ayuda a decidir más rápido
El valor principal de la laravel-tdd skill no es la teoría abstracta de TDD. Te ayuda a decidir:
- si un cambio debe empezar con un test unitario, de feature o de integración
- si Pest o PHPUnit debe ser el valor predeterminado del repositorio
- cuánta preparación de base de datos necesita realmente el test
- cuándo bastan los fakes y cuándo conviene ejercitar fronteras reales
Cuándo puede no ser la mejor opción
Si solo quieres un ejemplo de código puntual, quizá te resulte más simple un prompt amplio de Laravel. La laravel-tdd skill aporta más valor cuando el resultado tiene que encajar en un flujo de tests funcional, y te importa la mantenibilidad, la cobertura y una estructura consistente entre iteraciones.
Cómo usar la skill laravel-tdd
Instala la skill en tu configuración de Claude Code
Instala laravel-tdd con:
npx skills add affaan-m/everything-claude-code --skill laravel-tdd
Ese es el paso de laravel-tdd install que la mayoría de usuarios necesita. Después de instalarla, invócala en un repositorio Laravel donde el modelo pueda inspeccionar los tests existentes, la configuración de pruebas y el código que vas a cambiar.
Dale a la skill la forma de tarea correcta
El mejor laravel-tdd usage empieza con una petición concreta de comportamiento, no con una solicitud vaga de implementación. Un buen input describe:
- la funcionalidad o el bug
- el comportamiento esperado visible para el usuario
- los modelos, rutas, controladores, jobs o notificaciones implicados
- cualquier preferencia de framework de pruebas que ya use el repo
Ejemplo de un prompt más sólido:
“Usa laravel-tdd para añadir inicio de sesión sin contraseña mediante enlace por email. Prioriza el estilo de tests existente, escribe primero el feature test que falle y luego implementa el mínimo código necesario. Usa fakes cuando corresponda y mantén los tests alineados con las convenciones actuales de Laravel.”
Lee primero los archivos más útiles
Para esta laravel-tdd guide, empieza por SKILL.md y luego revisa la documentación de apoyo del repositorio si existe. En este repo, SKILL.md es la fuente principal de verdad, y las secciones más relevantes son:
When to UseHow It WorksRed-Green-Refactor CycleTest Layers- la guía sobre estrategia de base de datos
Si tu proyecto tiene sus propias convenciones de Laravel, compáralas con la skill antes de escribir tests para no chocar con el estilo local de pruebas.
Usa un flujo de trabajo que encaje con la intención de la skill
Un buen flujo de laravel-tdd es:
- definir el comportamiento en una frase
- elegir la capa de test que demuestre ese comportamiento
- escribir el test que falle
- implementar el mínimo código para que pase
- refactorizar solo después de que el test esté en verde
Cuando le pides al modelo que siga esta secuencia, reduces la probabilidad de detalles de implementación inventados y obtienes un resultado más fácil de aplicar en una base de código Laravel real.
Preguntas frecuentes sobre la skill laravel-tdd
¿laravel-tdd es solo para usuarios de PHPUnit?
No. La skill admite tanto PHPUnit como Pest, aunque Pest se prefiere para tests nuevos salvo que el proyecto ya esté estandarizado en PHPUnit. Si tu repo mezcla estilos, dile al modelo cuál debe imitar para que no introduzca incoherencias.
¿Necesito una suite de tests grande antes de usarla?
No. La laravel-tdd skill es útil incluso en proyectos pequeños porque te ayuda a elegir el nivel de test correcto para cada cambio. Es especialmente valiosa cuando quieres que los primeros tests marquen un patrón que el resto del equipo pueda seguir.
¿En qué se diferencia de un prompt normal de Laravel?
Un prompt normal puede generar código que funciona una vez pero ignora la estructura de tests. La laravel-tdd skill pone el foco en el flujo de trabajo primero-los-tests, en la elección de la capa de test y en la estrategia de base de datos, lo que la hace mejor para la automatización de tests y más probable de encajar en un proyecto Laravel real.
¿Cuándo debería saltarme esta skill?
Sáltala si no estás probando comportamiento de Laravel, si necesitas un prototipo rápido sin disciplina de tests o si tu app tiene un framework interno de pruebas estricto que entra en conflicto con las suposiciones de PHPUnit/Pest de la skill.
Cómo mejorar la skill laravel-tdd
Da comportamiento, no solo objetivos de implementación
Los mejores resultados de laravel-tdd vienen de especificaciones de comportamiento. En lugar de “construye un sistema de notificaciones”, di “envía una notificación por correo cuando una factura pase a estar vencida y verifícalo con un feature test”. Eso le da a la skill un objetivo verificable y reduce los intercambios de ida y vuelta.
Indica la frontera y el estilo de test desde el inicio
Dile al modelo qué debe probarse y cómo. Por ejemplo:
- “Usa un feature test para el endpoint HTTP y un unit test para la regla de precios.”
- “Usa
RefreshDatabaseporque el test toca Eloquent y policies.” - “Usa Pest salvo que la suite existente sea PHPUnit.”
Esos detalles ayudan a la laravel-tdd skill a evitar defaults equivocados y a producir una salida que encaje con tu repo.
Vigila dos modos de fallo habituales
Los problemas más comunes son sobreprobar detalles de implementación y elegir la capa de test equivocada. Si la primera pasada es demasiado de bajo nivel, pide una reescritura centrada en el comportamiento. Si la preparación del test parece pesada, pide al modelo que minimice fixtures, prefiera factories y simplifique la configuración de base de datos cuando sea posible.
Itera revisando el test que falla
Después de la primera salida, revisa si el test realmente fallaría por la razón correcta antes del cambio de código. Si no es así, pide una aserción más estricta, un fixture más limpio o un alcance más acotado. Esa es la forma más rápida de mejorar la salida de laravel-tdd para la automatización de tests en proyectos reales.