Laravel Boost

Laravel Boost accélère le développement assisté par IA : MCP, guidelines IA, Agent Skills — pour que votre agent comprenne en profondeur votre application Laravel.

​

Introduction

Laravel Boost est un package qui accélère le développement assisté par IA en fournissant les guidelines et les Agent Skills nécessaires pour que l’agent produise du code Laravel de qualité, conforme aux bonnes pratiques.

Boost fournit aussi une API documentaire puissante avec plus de 17 000 pages d’informations propres à Laravel et une recherche sémantique basée sur les embeddings. Boost indique aux agents (Claude Code, Cursor…) d’utiliser cette API pour rester à jour sur les dernières fonctionnalités et bonnes pratiques.

​

Installation

composer require laravel/boost --dev

Ensuite, installez le serveur MCP et les guidelines :

php artisan boost:install

boost:install génère guidelines et fichiers Skills pour l’agent choisi.

Une fois terminé, vous pouvez commencer à coder avec Cursor, Claude Code ou votre agent IA préféré.

Les fichiers générés (.mcp.json, CLAUDE.md, AGENTS.md, junie/, boost.json…) peuvent être ajoutés au .gitignore. Ils sont regénérés par boost:install / boost:update.

​

Configuration par agent

Cursor

1. Ouvrez la palette de commandes (Cmd+Shift+P / Ctrl+Shift+P)
2. Choisissez « /open MCP Settings » puis Enter
3. Activez le toggle laravel-boost

Claude Code

Généralement automatique. Sinon :

claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp

Codex

Généralement automatique. Sinon :

codex mcp add laravel-boost -- php "artisan" "boost:mcp"

Gemini CLI

Généralement automatique. Sinon :

gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp

GitHub Copilot (VS Code)

1. Palette de commandes (Cmd+Shift+P / Ctrl+Shift+P)
2. « MCP: List Servers » puis Enter
3. Sélectionnez laravel-boost puis Enter
4. « Start server »

Junie

1. Appuyez deux fois sur Shift pour la palette
2. Cherchez « MCP Settings »
3. Cochez laravel-boost
4. « Apply »

​

Mise à jour des ressources Boost

Mettez à jour périodiquement pour refléter les dernières versions des packages installés.

php artisan boost:update

Vous pouvez l’automatiser via post-update-cmd de Composer.

{
  "scripts": {
    "post-update-cmd": [
      "@php artisan boost:update --ansi"
    ]
  }
}

Par défaut, seules les ressources déjà publiées sont mises à jour. Pour détecter les nouveaux packages et proposer leurs guidelines/skills, utilisez --discover.

php artisan boost:update --discover

​

Serveur MCP

Le serveur MCP fournit à l’agent des outils pour interagir avec l’application : inspection, requêtes DB, exécution de code…

​

Outils disponibles

Outil	Description
Application Info	Versions PHP/Laravel, DB, packages, modèles Eloquent
Browser Logs	Logs et erreurs du navigateur
Database Connections	Connexions disponibles (dont défaut)
Database Query	Exécution de requêtes
Database Schema	Lecture du schéma
Get Absolute URL	Convertit une URI relative en URL absolue
Last Error	Dernière erreur dans les logs
Read Log Entries	N derniers logs
Search Docs	Interroge l’API documentaire Laravel selon les packages installés

​

Enregistrement manuel du serveur MCP

Selon l’éditeur, un enregistrement manuel peut être nécessaire.

Champ	Valeur
Command	php
Args	artisan boost:mcp

En JSON :

{
    "mcpServers": {
        "laravel-boost": {
            "command": "php",
            "args": ["artisan", "boost:mcp"]
        }
    }
}

​

Guidelines IA

Fichiers d’instructions préchargés au démarrage de l’agent : conventions et patterns fondamentaux de l’écosystème Laravel — pour un code cohérent et de qualité.

​

Guidelines disponibles

core s’applique quelle que soit la version.

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

Voir Mise à jour des ressources Boost.

​

Ajouter des guidelines personnalisées

Ajoutez des fichiers .blade.php ou .md dans .ai/guidelines/*. Ils sont fusionnés avec ceux de Boost lors de boost:install.

​

Surcharger une guideline Boost

Créez une guideline au chemin correspondant : Boost utilise la vôtre plutôt que la sienne.

Par exemple, pour surcharger « Inertia React v2 Form Guidance » : .ai/guidelines/inertia-react/2/forms.blade.php.

​

Guidelines pour packages tiers

Si vous maintenez un package et voulez fournir vos guidelines, ajoutez resources/boost/guidelines/core.blade.php. boost:install chez les utilisateurs les intégrera.

Rédigez court, orienté action, avec des exemples de code.

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

Les Agent Skills sont des modules ciblés, activés à la demande. Ils ne sont pas préchargés — ils apportent des patterns détaillés seulement quand pertinent, ce qui limite le context bloat et améliore la qualité.

Sélectionnez la fonctionnalité Skills lors de boost:install : les skills sont installés selon composer.json. Ex. : présence de livewire/livewire → livewire-development installé.

​

Skills disponibles

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

Voir Mise à jour.

​

Créer un skill

Ajoutez .ai/skills/{skill-name}/SKILL.md. boost:update l’installera aux côtés des skills Boost.

Exemple pour une logique métier :

.ai/skills/creating-invoices/SKILL.md

​

Surcharger un skill

Créez un skill du même nom : Boost utilise le vôtre.

Par exemple, .ai/skills/livewire-development/SKILL.md remplace livewire-development.

​

Skills de packages tiers

Ajoutez resources/boost/skills/{skill-name}/SKILL.md dans votre package. boost:install proposera son installation.

Format Agent Skills (frontmatter YAML + Markdown) :

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

​

Guidelines vs Skills

Guidelines : préchargées, généralistes, appliquées à tout le code.

Skills : à la demande, ciblés (composants Livewire, tests Pest…).

Aspect	Guidelines	Skills
Chargement	Préchargé, toujours actif	À la demande
Portée	Large, fondamentale	Focalisée, spécifique à une tâche
But	Conventions et bonnes pratiques	Patterns d’implémentation détaillés

​

API documentaire

Boost expose une base de connaissances de 17 000+ documents Laravel avec recherche sémantique (embeddings).

L’outil MCP Search Docs interroge cette API selon les packages installés. Les guidelines et skills orientent l’agent à l’utiliser.

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

​

Étendre Boost

Boost fonctionne d’emblée avec les principaux IDE / agents. Sinon, créez votre agent et intégrez-le.

​

Support d’un nouvel IDE / agent

Créez une classe héritant de Laravel\Boost\Install\Agents\Agent et implémentez selon vos besoins :

• Laravel\Boost\Contracts\SupportsGuidelines
• Laravel\Boost\Contracts\SupportsMcp
• Laravel\Boost\Contracts\SupportsSkills

​

Implémentation

<?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
{
    // Votre implémentation...
}

Voir ClaudeCode.php.

​

Enregistrement

Dans boot() de App\Providers\AppServiceProvider :

use Laravel\Boost\Boost;

public function boot(): void
{
    Boost::registerAgent('customagent', CustomAgent::class);
}

L’agent apparaîtra dans le choix de php artisan boost:install.