Skip to main content

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

Ensuite, installez le serveur MCP et les guidelines :
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.
Vous pouvez l’automatiser via post-update-cmd de Composer.
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.

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

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

Ajoutez resources/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
Stockez les règles sous forme de fichiers Markdown dans le répertoire .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.
Boost maintient également un fichier .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.
L’agent appelle l’outil MCP 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 skill infer-conventions crée des règles à partir du code que vous avez déjà écrit. Commencez par demander à l’agent :
Le skill enquête sur les conventions à l’aide d’une checklist couvrant validation, contrôleurs, autorisation, modèles, architecture, tests, front-end, base de données et console, puis explore librement d’autres patterns (classes de base, traits partagés, structure des modules, etc.). Le skill enregistre ce que le code fait réellement, et non ce qu’il devrait idéalement faire. Il n’enregistre que les conventions vraiment distinctives, avec suffisamment de preuves, et exclut les valeurs par défaut du framework ou ce que Pint et Rector imposent déjà. Lorsque les patterns sont mélangés, il le signale plutôt que d’imposer une règle. Avant d’écrire la moindre règle, il présente les conventions découvertes et les preuves associées pour approbation. Pour enregistrer toutes les conventions sans confirmation, dites « yolo ».

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 MCP record-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 MCP Search 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 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

Voir ClaudeCode.php.

Enregistrement

Dans boot() de App\Providers\AppServiceProvider :
L’agent apparaîtra dans le choix de php artisan boost:install.
Dernière modification le 21 août 2026