> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# Laravel Boost
> Laravel Boost es un paquete que acelera el desarrollo asistido por IA. A través de un servidor MCP, guías para IA y Agent Skills, permite que los agentes de codificación con IA comprendan en profundidad tu aplicación Laravel.
## 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.
```shell theme={null}
composer require laravel/boost --dev
```
A continuación, instala el servidor MCP y las guías de codificación.
```shell theme={null}
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
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`.
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:
```shell theme={null}
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:
```shell theme={null}
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:
```shell theme={null}
gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp
```
1. Abre la paleta de comandos (`Cmd+Shift+P` o `Ctrl+Shift+P`).
2. Elige "MCP: List Servers" y pulsa `Enter`.
3. Elige `laravel-boost` y pulsa `Enter`.
4. Selecciona "Start server".
1. Pulsa `Shift` dos veces para abrir la paleta de comandos.
2. Busca "MCP Settings" y pulsa `Enter`.
3. Marca la casilla situada junto a `laravel-boost`.
4. 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`.
```shell theme={null}
php artisan boost:update
```
También puedes automatizarlo añadiéndolo al script `post-update-cmd` de Composer.
```json theme={null}
{
"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`.
```shell theme={null}
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:
```json theme={null}
{
"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 |
Para mantener las guías de IA actualizadas, consulta [Actualizar los recursos de Boost](#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.
```php theme={null}
## Package Name
This package provides [brief description of functionality].
### Features
- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:
@verbatim
$result = PackageName::featureTwo($param1, $param2);
@endverbatim
```
## Agent Skills
Los [Agent Skills](https://agentskills.io/home) 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 |
Para mantener las skills actualizadas, consulta [Actualizar los recursos de Boost](#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:
```
.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.
```markdown theme={null}
---
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 theme={null}