Passer au contenu principal

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

  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

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

OutilDescription
Application InfoVersions PHP/Laravel, DB, packages, modèles Eloquent
Browser LogsLogs et erreurs du navigateur
Database ConnectionsConnexions disponibles (dont défaut)
Database QueryExécution de requêtes
Database SchemaLecture du schéma
Get Absolute URLConvertit une URI relative en URL absolue
Last ErrorDernière erreur dans les logs
Read Log EntriesN derniers logs
Search DocsInterroge l’API documentaire Laravel selon les packages installés

Enregistrement manuel du serveur MCP

Selon l’éditeur, un enregistrement manuel peut être nécessaire.
ChampValeur
Commandphp
Argsartisan 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.
PackageVersions
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

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/livewirelivewire-development installé.

Skills disponibles

SkillPackage
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

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…).
AspectGuidelinesSkills
ChargementPréchargé, toujours actifÀ la demande
PortéeLarge, fondamentaleFocalisée, spécifique à une tâche
ButConventions et bonnes pratiquesPatterns 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.
PackageVersions
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

É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.
Dernière modification le 13 juillet 2026