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
Claude Code
Codex
Gemini CLI
GitHub Copilot (VS Code)
Junie
- Ouvrez la palette de commandes (
Cmd+Shift+P / Ctrl+Shift+P)
- Choisissez « /open MCP Settings » puis
Enter
- Activez le toggle
laravel-boost
Généralement automatique. Sinon :claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp
Généralement automatique. Sinon :codex mcp add laravel-boost -- php "artisan" "boost:mcp"
Généralement automatique. Sinon :gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp
- Palette de commandes (
Cmd+Shift+P / Ctrl+Shift+P)
- « MCP: List Servers » puis
Enter
- Sélectionnez
laravel-boost puis Enter
- « Start server »
- Appuyez deux fois sur
Shift pour la palette
- Cherchez « MCP Settings »
- Cochez
laravel-boost
- « Apply »
Mise à jour des ressources Boost
Mettez à jour périodiquement pour refléter les dernières versions des packages installés.
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 |
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 |
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.