Skip to main content

Introducción

Laravel Boost es un paquete que acelera el desarrollo asistido por IA proporcionando a los agentes las guías y los Agent Skills necesarios para escribir aplicaciones Laravel de alta calidad siguiendo las buenas prácticas del framework. Boost también incluye una potente API de documentación del ecosistema Laravel que combina una base de conocimiento con más de 17.000 fragmentos específicos de Laravel con búsqueda semántica basada en embeddings. Boost instruye a agentes como Claude Code o Cursor para que utilicen esta API y aprendan así las funcionalidades y las buenas prácticas más recientes de Laravel.

Instalación

Instala Laravel Boost con Composer.
A continuación, instala el servidor MCP y las guías de codificación.
El comando boost:install genera las guías y los archivos de skill correspondientes al agente de codificación que hayas seleccionado durante la instalación. Al terminar la instalación puedes empezar a programar con Cursor, Claude Code o el agente de IA que prefieras.
Los archivos generados de configuración MCP (.mcp.json), los archivos de guía (CLAUDE.md, AGENTS.md, junie/, etc.) y el archivo de configuración boost.json pueden añadirse al .gitignore de la aplicación. Estos archivos se regeneran automáticamente cuando ejecutas boost:install o boost:update.

Configuración del agente

  1. Abre la paleta de comandos (Cmd+Shift+P o Ctrl+Shift+P).
  2. Elige “/open MCP Settings” y pulsa Enter.
  3. Activa el interruptor de laravel-boost.

Actualizar los recursos de Boost

Es recomendable actualizar periódicamente los recursos locales de Boost (guías de IA y skills) para reflejar las versiones más recientes de los paquetes del ecosistema Laravel instalados. Utiliza el comando Artisan boost:update.
También puedes automatizarlo añadiéndolo al script post-update-cmd de Composer.
Por defecto, boost:update actualiza únicamente los recursos de Boost que ya se han publicado en la aplicación. Si quieres que también detecte los paquetes recién instalados y ofrezca publicar sus guías y skills, utiliza la opción --discover.

Servidor MCP

Laravel Boost proporciona un servidor MCP (Model Context Protocol) que expone herramientas para que los agentes interactúen con tu aplicación Laravel. Con ellas, el agente puede inspeccionar la estructura de la aplicación, consultar la base de datos o ejecutar código.

Herramientas MCP disponibles

Registro manual del servidor MCP

En algunos editores tendrás que registrar manualmente el servidor MCP de Laravel Boost. Utiliza la siguiente información al hacerlo: Ejemplo en formato JSON:

Guías para IA

Las guías para IA son archivos de instrucciones que se cargan de forma anticipada para proporcionar al agente contexto imprescindible sobre los paquetes del ecosistema Laravel. Estas guías incluyen convenciones básicas, buenas prácticas y patrones propios del framework, y ayudan al agente a generar código coherente y de calidad.

Guías disponibles

Laravel Boost incluye guías para los siguientes paquetes y frameworks. Las guías core contienen consejos genéricos que se aplican independientemente de la versión.
Para mantener las guías de IA actualizadas, consulta Actualizar los recursos de Boost.

Añadir guías personalizadas

Para añadir tus propias guías personalizadas a Laravel Boost, añade archivos .blade.php o .md al directorio .ai/guidelines/* de tu aplicación. Estos archivos se combinan automáticamente con las guías de Laravel Boost al ejecutar boost:install.

Sobrescribir las guías de Boost

Puedes sobrescribir las guías integradas de Boost creando una guía personalizada cuyo path coincida. Si creas una guía personalizada en un path que coincida con una guía existente de Boost, se utilizará la versión personalizada en lugar de la incorporada. Por ejemplo, para sobrescribir la guía «Inertia React v2 Form Guidance» de Boost, crea el archivo .ai/guidelines/inertia-react/2/forms.blade.php. Cuando ejecutes boost:install, Boost usará la guía personalizada en lugar de la predeterminada.

Guías para paquetes de terceros

Si gestionas un paquete de terceros y quieres que Boost incluya guías de IA para él, añade el archivo resources/boost/guidelines/core.blade.php a tu paquete. Cuando los usuarios de tu paquete ejecuten php artisan boost:install, Boost cargará automáticamente esas guías. En las guías de IA describe la finalidad del paquete, la estructura de archivos o convenciones requeridas y cómo crear o usar sus funciones principales (incluyendo ejemplos de comandos y fragmentos de código). Escribe de forma concisa, orientada a la acción y centrada en las buenas prácticas para que la IA genere el código correcto para el usuario.

Agent Skills

Los Agent Skills son módulos de conocimiento ligeros y focalizados que el agente activa bajo demanda cuando trabaja en un dominio concreto. A diferencia de las guías, que se cargan por adelantado, las skills solo se cargan cuando son relevantes, cargando entonces patrones detallados y buenas prácticas. De este modo se reduce la sobrecarga de contexto y aumenta la calidad del código generado por la IA. Cuando ejecutas boost:install y seleccionas las skills como funcionalidad, se instalan automáticamente según los paquetes detectados en composer.json. Por ejemplo, si el proyecto contiene livewire/livewire, se instala automáticamente la skill livewire-development. Las skills incluidas con Boost, como infer-conventions, se instalan con independencia de los paquetes presentes.

Skills disponibles

Para mantener las skills actualizadas, consulta Actualizar los recursos de Boost.

Crear skills personalizadas

Para crear tus propias skills personalizadas, añade un archivo SKILL.md al directorio .ai/skills/{skill-name}/ de la aplicación. Cuando ejecutes boost:update, las skills personalizadas se instalarán junto con las incorporadas de Boost. Por ejemplo, para crear una skill personalizada para la lógica de dominio de tu aplicación:

Sobrescribir skills

Puedes sobrescribir las skills integradas de Boost creando una skill personalizada con el mismo nombre. Si creas una skill personalizada con un nombre que coincida con una skill existente de Boost, se utilizará la versión personalizada en lugar de la incorporada. Por ejemplo, para sobrescribir la skill livewire-development de Boost, crea el archivo .ai/skills/livewire-development/SKILL.md. Al ejecutar boost:update, Boost usará la skill personalizada en lugar de la predeterminada.

Skills para paquetes de terceros

Si gestionas un paquete de terceros y quieres que Boost incluya skills para él, añade el archivo resources/boost/skills/{skill-name}/SKILL.md a tu paquete. Cuando los usuarios ejecuten php artisan boost:install, Boost instalará las skills automáticamente si el usuario lo desea. Las skills de Boost siguen el formato Agent Skills y deben organizarse como una carpeta con un archivo SKILL.md que contiene la frontmatter YAML y las instrucciones en Markdown. El SKILL.md debe incluir la frontmatter obligatoria (name y description) y opcionalmente scripts, plantillas y material de referencia.

Guías frente a skills

Laravel Boost ofrece dos formas de proporcionar contexto sobre tu aplicación al agente de IA: guías y skills. Las guías se cargan por adelantado al iniciarse el agente y aportan contexto imprescindible sobre las convenciones y buenas prácticas de Laravel aplicables a toda la base de código. Las skills se activan bajo demanda cuando se trabaja en una tarea concreta e incluyen patrones detallados de un dominio específico (por ejemplo, componentes de Livewire o pruebas de Pest). Al cargarlas solo cuando son necesarias, se reduce la sobrecarga de contexto y mejora la calidad del código. Las guías y las skills aportan conocimiento sobre el ecosistema de Laravel. Para transmitir a los agentes de IA convenciones específicas de la aplicación, utiliza reglas de proyecto.

Reglas de proyecto

Mientras las guías y las skills enseñan cómo escribir código Laravel, las reglas de proyecto enseñan cómo escribir el código de tu aplicación. Las reglas cubren aspectos que, de otro modo, tendrías que volver a explicar en cada sesión nueva, como:
  • Decisiones de diseño tomadas por ti, por los agentes o por miembros del equipo
  • Guías de estilo y preferencias difíciles de imponer a los agentes
  • Restricciones y trampas que no pueden deducirse del código circundante
Guarda las reglas como archivos Markdown en el directorio .ai/rules de la aplicación y compromételas en el control de versiones. A diferencia de la memoria del agente, que es por usuario y por sesión, las reglas se comparten entre el equipo y con todos los agentes que trabajan en la aplicación. La frontmatter de cada archivo de regla define los patrones (globs) de archivos a los que se aplica.
Boost también mantiene un archivo .ai/rules/index.md que registra la asociación entre globs y archivos de regla. Los agentes reciben la instrucción de consultar este índice antes de planificar o editar archivos, para que solo se carguen las reglas relevantes.
A diferencia de .mcp.json o de los archivos de guía generados, el directorio .ai/rules se compromete en el control de versiones para que el equipo pueda compartir las reglas.

Registrar reglas

Puedes registrar una regla simplemente pidiéndole al agente que la recuerde.
El agente llama a la herramienta MCP record-rule de Boost con un glob, un title corto y una note. Boost registra la regla en el área relevante y, si es necesario, crea un archivo de regla y actualiza el índice. No crees archivos de regla manualmente; regístralos siempre a través de la herramienta record-rule. Cuando se registra una regla, Boost regenera .ai/rules/index.md. Los agentes encuentran las reglas aplicables a través de este índice, así que un archivo de regla añadido manualmente no se descubre hasta que se regenera el índice.

Deducir las convenciones de la aplicación

Las aplicaciones ya existentes tienen convenciones que se han ido acumulando con los años. La skill infer-conventions crea reglas a partir del código que ya has escrito. Empieza pidiéndoselo al agente:
La skill investiga las convenciones siguiendo un checklist que cubre validación, controladores, autorización, modelos, arquitectura, testing, frontend, base de datos y consola, y a continuación investiga libremente otros patrones, como clases base, traits compartidos y estructura de módulos. La skill registra lo que el código hace en realidad, no lo que idealmente debería hacer. Solo registra convenciones distintivas con evidencia suficiente y excluye los valores por defecto del framework o cualquier cosa que Pint y Rector ya impongan. Cuando los patrones están mezclados, lo reporta en lugar de forzar una regla. Antes de escribir ninguna regla, presenta las convenciones detectadas y la evidencia para que las apruebes. Para registrar todas las convenciones sin confirmación, di “yolo”.

Desactivar las reglas de proyecto

Las reglas de proyecto están activadas por defecto. Para desactivarlas por completo, define esta variable de entorno. La herramienta MCP record-rule se elimina y Boost deja de gestionar el directorio .ai/rules.

API de documentación

Laravel Boost incluye una API de documentación que da al agente acceso a una base de conocimiento con más de 17.000 fragmentos específicos de Laravel. La API utiliza búsqueda semántica con embeddings para ofrecer resultados precisos y adaptados al contexto. La herramienta MCP Search Docs permite al agente consultar el servicio hospedado de documentación de Laravel según los paquetes instalados. Las guías y skills de IA de Boost instruyen automáticamente al agente para que utilice esta API.

Extender Boost

Boost funciona listo para usar con muchos IDEs y agentes de IA habituales. Si tu herramienta aún no está soportada, puedes crear tu propio agente e integrarlo con Boost.

Añadir soporte para otro IDE o agente de IA

Para añadir soporte para un IDE o agente de IA nuevo, crea una clase que herede de Laravel\Boost\Install\Agents\Agent e implementa uno o varios de los siguientes contratos según necesites:
  • Laravel\Boost\Contracts\SupportsGuidelines: añade compatibilidad con las guías de IA.
  • Laravel\Boost\Contracts\SupportsMcp: añade compatibilidad con MCP.
  • Laravel\Boost\Contracts\SupportsSkills: añade compatibilidad con Agent Skills.

Implementación del agente

Como referencia, consulta ClaudeCode.php.

Registro del agente

Registra el agente personalizado en el método boot de App\Providers\AppServiceProvider.
Una vez registrado, el agente aparecerá como opción al ejecutar php artisan boost:install.
Última modificación el 21 de agosto de 2026