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.

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

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.

Claude Code

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

Codex

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"

Gemini CLI

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

GitHub Copilot (VS Code)

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”.

Junie

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.

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 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

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

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.

​

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.