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
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
Mise à jour des ressources Boost
Mettez à jour périodiquement pour refléter les dernières versions des packages installés.post-update-cmd de Composer.
--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
Enregistrement manuel du serveur MCP
Selon l’éditeur, un enregistrement manuel peut être nécessaire.
En JSON :
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.
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, ajoutezresources/boost/guidelines/core.blade.php. boost:install chez les utilisateurs les intégrera.
Rédigez court, orienté action, avec des exemples de code.
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 deboost:install : les skills sont installés selon composer.json. Ex. : présence de livewire/livewire → livewire-development installé. Les skills fournis avec Boost, comme infer-conventions, sont installés indépendamment des packages présents.
Skills disponibles
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 :
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
Ajoutezresources/boost/skills/{skill-name}/SKILL.md dans votre package. boost:install proposera son installation.
Format Agent Skills (frontmatter YAML + Markdown) :
Guidelines vs Skills
Guidelines : préchargées, généralistes, appliquées à tout le code. Skills : à la demande, ciblés (composants Livewire, tests Pest…).
Les guidelines et les skills apportent des connaissances sur l’écosystème Laravel. Pour transmettre aux agents IA les conventions propres à votre application, utilisez les règles projet.
Règles projet
Les guidelines et les skills apprennent à écrire du code Laravel ; les règles projet, elles, apprennent à écrire le code de votre application. Elles couvrent tout ce que vous auriez sinon à ré-expliquer à chaque nouvelle session, par exemple :- Décisions de conception prises par vous, les agents ou les membres de l’équipe
- Guides de style et préférences difficiles à imposer aux agents
- Contraintes et pièges impossibles à déduire du code environnant
.ai/rules de l’application, et versionnez-les avec le code source. Contrairement à la mémoire d’agent, propre à chaque utilisateur et à chaque session, les règles sont partagées entre l’équipe et avec chaque agent qui travaille sur l’application.
Le frontmatter de chaque fichier de règle définit les globs de fichiers auxquels il s’applique.
.ai/rules/index.md qui enregistre la correspondance entre les globs et les fichiers de règles. Les agents sont invités à consulter cet index avant toute planification ou modification de fichiers, afin de ne charger que les règles pertinentes.
Contrairement à
.mcp.json ou aux fichiers de guidelines générés, le répertoire .ai/rules est versionné avec le code source afin d’être partagé au sein de l’équipe.Enregistrer une règle
Vous pouvez enregistrer une règle simplement en demandant à l’agent de la retenir.record-rule de Boost avec un glob, un title court et une note. Boost enregistre la règle dans la zone concernée et, si nécessaire, crée le fichier de règle et met à jour l’index.
Ne créez pas de fichier de règle manuellement : passez toujours par l’outil record-rule. Lorsqu’une règle est enregistrée, Boost régénère .ai/rules/index.md. Les agents trouvent les règles applicables via cet index ; un fichier de règle ajouté manuellement n’est donc pas découvert tant que l’index n’est pas régénéré.
Déduire les conventions d’une application
Les applications existantes ont accumulé, au fil des ans, des conventions. Le skillinfer-conventions crée des règles à partir du code que vous avez déjà écrit. Commencez par demander à l’agent :
Désactiver les règles projet
Les règles projet sont activées par défaut. Pour les désactiver entièrement, définissez cette variable d’environnement. L’outil MCPrecord-rule est retiré et Boost cesse de gérer le répertoire .ai/rules.
API documentaire
Boost expose une base de connaissances de 17 000+ documents Laravel avec recherche sémantique (embeddings). L’outil MCPSearch Docs interroge cette API selon les packages installés. Les guidelines et skills orientent l’agent à l’utiliser.
É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 deLaravel\Boost\Install\Agents\Agent et implémentez selon vos besoins :
Laravel\Boost\Contracts\SupportsGuidelinesLaravel\Boost\Contracts\SupportsMcpLaravel\Boost\Contracts\SupportsSkills
Implémentation
Enregistrement
Dansboot() de App\Providers\AppServiceProvider :
php artisan boost:install.