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.
composer require laravel/boost --dev
A continuación, instala el servidor MCP y las guías de codificación.
php artisan boost:install
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
Cursor
Claude Code
Codex
Gemini CLI
GitHub Copilot (VS Code)
Junie
- Abre la paleta de comandos (
Cmd+Shift+P o Ctrl+Shift+P).
- Elige “/open MCP Settings” y pulsa
Enter.
- Activa el interruptor de
laravel-boost.
La compatibilidad con Claude Code se habilita normalmente de forma automática. Si no es así, abre una terminal en el directorio del proyecto y ejecuta:claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp
La compatibilidad con Codex se habilita normalmente de forma automática. Si no es así, abre una terminal en el directorio del proyecto y ejecuta:codex mcp add laravel-boost -- php "artisan" "boost:mcp"
La compatibilidad con Gemini CLI se habilita normalmente de forma automática. Si no es así, abre una terminal en el directorio del proyecto y ejecuta:gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp
- Abre la paleta de comandos (
Cmd+Shift+P o Ctrl+Shift+P).
- Elige “MCP: List Servers” y pulsa
Enter.
- Elige
laravel-boost y pulsa Enter.
- Selecciona “Start server”.
- Pulsa
Shift dos veces para abrir la paleta de comandos.
- Busca “MCP Settings” y pulsa
Enter.
- Marca la casilla situada junto a
laravel-boost.
- Haz clic en “Apply” abajo a la derecha.
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.
{
"scripts": {
"post-update-cmd": [
"@php artisan boost:update --ansi"
]
}
}
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.
php artisan boost:update --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
| Nombre de la herramienta | Descripción |
|---|
| Application Info | Lee las versiones de PHP y Laravel, el motor de base de datos, la lista de paquetes del ecosistema con sus versiones y los modelos Eloquent. |
| Browser Logs | Lee los logs y errores del navegador. |
| Database Connections | Muestra las conexiones de base de datos disponibles, incluida la conexión por defecto. |
| Database Query | Ejecuta una consulta sobre la base de datos. |
| Database Schema | Lee el esquema de la base de datos. |
| Get Absolute URL | Convierte URIs relativas en URLs absolutas para que el agente genere URLs válidas. |
| Last Error | Lee el último error del archivo de log de la aplicación. |
| Read Log Entries | Lee las últimas N entradas del log. |
| Search Docs | Consulta el servicio hospedado de documentación de Laravel basándose en los paquetes instalados. |
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:
| Campo | Valor |
|---|
| Command | php |
| Args | artisan boost:mcp |
Ejemplo en formato JSON:
{
"mcpServers": {
"laravel-boost": {
"command": "php",
"args": ["artisan", "boost:mcp"]
}
}
}
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.
| Paquete | Versiones compatibles |
|---|
| Core & Boost | core |
| Laravel Framework | core, 10.x, 11.x, 12.x |
| Livewire | core, 2.x, 3.x, 4.x |
| Flux UI | core, free, pro |
| Folio | core |
| Herd | core |
| Inertia Laravel | core, 1.x, 2.x, 3.x |
| Inertia React | core, 1.x, 2.x, 3.x |
| Inertia Vue | core, 1.x, 2.x, 3.x |
| Inertia Svelte | core, 1.x, 2.x, 3.x |
| MCP | core |
| Pennant | core |
| Pest | core, 3.x, 4.x |
| PHPUnit | core |
| Pint | core |
| Sail | core |
| Tailwind CSS | core, 3.x, 4.x |
| Livewire Volt | core |
| Wayfinder | core |
| Enforce Tests | conditional |
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.
## Package Name
This package provides [brief description of functionality].
### Features
- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:
@verbatim
<code-snippet name="How to use Feature 2" lang="php">
$result = PackageName::featureTwo($param1, $param2);
</code-snippet>
@endverbatim
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.
Skills disponibles
| Skill | Paquete |
|---|
| fluxui-development | Flux UI |
| folio-routing | Folio |
| inertia-react-development | Inertia React |
| inertia-svelte-development | Inertia Svelte |
| inertia-vue-development | Inertia Vue |
| livewire-development | Livewire |
| mcp-development | MCP |
| pennant-development | Pennant |
| pest-testing | Pest |
| tailwindcss-development | Tailwind CSS |
| volt-development | Volt |
| wayfinder-development | Wayfinder |
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:
.ai/skills/creating-invoices/SKILL.md
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.
---
name: package-name-development
description: Build and work with PackageName features, including components and workflows.
---
# Package Name Development
## When to use this skill
Use this skill when working with PackageName features...
## Features
- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:
$result = PackageName::featureTwo($param1, $param2);
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.
| Aspecto | Guías | Skills |
|---|
| Momento de carga | Se cargan siempre por adelantado | Bajo demanda, solo cuando son relevantes |
| Ámbito | Amplio, transversal | Focalizado, específico de la tarea |
| Objetivo | Convenciones básicas y buenas prácticas | Patrones detallados de implementación |
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.
| Paquete | Versiones compatibles |
|---|
| Laravel Framework | 10.x, 11.x, 12.x |
| Filament | 2.x, 3.x, 4.x, 5.x |
| Flux UI | 2.x Free, 2.x Pro |
| Inertia | 1.x, 2.x |
| Livewire | 1.x, 2.x, 3.x, 4.x |
| Nova | 4.x, 5.x |
| Pest | 3.x, 4.x |
| Tailwind CSS | 3.x, 4.x |
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
<?php
declare(strict_types=1);
namespace App;
use Laravel\Boost\Contracts\SupportsGuidelines;
use Laravel\Boost\Contracts\SupportsMcp;
use Laravel\Boost\Contracts\SupportsSkills;
use Laravel\Boost\Install\Agents\Agent;
class CustomAgent extends Agent implements SupportsGuidelines, SupportsMcp, SupportsSkills
{
// Your implementation...
}
Como referencia, consulta ClaudeCode.php.
Registro del agente
Registra el agente personalizado en el método boot de App\Providers\AppServiceProvider.
use Laravel\Boost\Boost;
public function boot(): void
{
Boost::registerAgent('customagent', CustomAgent::class);
}
Una vez registrado, el agente aparecerá como opción al ejecutar php artisan boost:install.