Saltar al contenido principal

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

  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.
php 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 herramientaDescripción
Application InfoLee 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 LogsLee los logs y errores del navegador.
Database ConnectionsMuestra las conexiones de base de datos disponibles, incluida la conexión por defecto.
Database QueryEjecuta una consulta sobre la base de datos.
Database SchemaLee el esquema de la base de datos.
Get Absolute URLConvierte URIs relativas en URLs absolutas para que el agente genere URLs válidas.
Last ErrorLee el último error del archivo de log de la aplicación.
Read Log EntriesLee las últimas N entradas del log.
Search DocsConsulta 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:
CampoValor
Commandphp
Argsartisan 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.
PaqueteVersiones compatibles
Core & Boostcore
Laravel Frameworkcore, 10.x, 11.x, 12.x
Livewirecore, 2.x, 3.x, 4.x
Flux UIcore, free, pro
Foliocore
Herdcore
Inertia Laravelcore, 1.x, 2.x, 3.x
Inertia Reactcore, 1.x, 2.x, 3.x
Inertia Vuecore, 1.x, 2.x, 3.x
Inertia Sveltecore, 1.x, 2.x, 3.x
MCPcore
Pennantcore
Pestcore, 3.x, 4.x
PHPUnitcore
Pintcore
Sailcore
Tailwind CSScore, 3.x, 4.x
Livewire Voltcore
Wayfindercore
Enforce Testsconditional
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.
## 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

SkillPaquete
fluxui-developmentFlux UI
folio-routingFolio
inertia-react-developmentInertia React
inertia-svelte-developmentInertia Svelte
inertia-vue-developmentInertia Vue
livewire-developmentLivewire
mcp-developmentMCP
pennant-developmentPennant
pest-testingPest
tailwindcss-developmentTailwind CSS
volt-developmentVolt
wayfinder-developmentWayfinder
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:
.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.
AspectoGuíasSkills
Momento de cargaSe cargan siempre por adelantadoBajo demanda, solo cuando son relevantes
ÁmbitoAmplio, transversalFocalizado, específico de la tarea
ObjetivoConvenciones básicas y buenas prácticasPatrones 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.
PaqueteVersiones compatibles
Laravel Framework10.x, 11.x, 12.x
Filament2.x, 3.x, 4.x, 5.x
Flux UI2.x Free, 2.x Pro
Inertia1.x, 2.x
Livewire1.x, 2.x, 3.x, 4.x
Nova4.x, 5.x
Pest3.x, 4.x
Tailwind CSS3.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.
Última modificación el 13 de julio de 2026