🤖 Laravel Boost : quand Laravel parle aux agents IA

📚 Introduction

Les agents IA ont changé la façon dont on lit du code. Mais jusqu’ici, leur capacité à agir sur une application restait limitée : ils proposaient du code, à charge pour le développeur d’exécuter, vérifier, recopier. Sur un projet Laravel, le va-et-vient entre l’assistant et php artisan tinker cassait largement le flow.

Laravel Boost comble ce gap. C’est un package officiel qui expose une application Laravel comme un serveur MCP (Model Context Protocol) : routes, modèles, jobs, configuration, base de données, logs deviennent autant d’outils que l’agent peut interroger ou exécuter directement.

🔌 Ce que Boost expose

Une fois installé, Boost déclare un ensemble d’outils MCP standardisés (côté serveur boost:mcp) :

• Application Info : versions PHP / Laravel, moteur de base de données, packages écosystème installés avec leur version, modèles Eloquent.
• Database Schema et Database Query : inspection du schéma et exécution de requêtes sur les connexions disponibles.
• Read Log Entries et Last Error : lecture des N dernières entrées de log et de la dernière erreur (souvent couplée avec Laravel Pail).
• Browser Logs : récupération des logs et erreurs côté navigateur.
• Get Absolute URL : conversion des chemins relatifs en URLs absolues pour que l’agent produise des liens valides.
• Search Docs : API documentaire hébergée par Laravel, indexée sur 17 000+ pièces d’information avec recherche sémantique, ciblée sur les versions installées (Framework 10/11/12/13, Livewire 1-4, Inertia 1-2, Filament 2-5, Nova 4-5, Pest 3-4, Tailwind 3-4).

À côté de ces outils, Boost installe deux briques complémentaires : des AI Guidelines (chargées en amont, pour rappeler les conventions Laravel à l’agent) et des Agent Skills au format agentskills.io (chargées à la demande sur un domaine précis : Livewire, Pest, Volt, Flux UI, Wayfinder…). C’est la combinaison “tools + guidelines + skills” qui rend l’agent vraiment “Laravel-conscient” plutôt que générique.

Conséquence concrète : un agent peut répondre à “pourquoi cet utilisateur ne reçoit pas son email ?” en allant lui-même lire l’utilisateur en base, consulter la dernière erreur via Last Error, croiser avec la doc et proposer un correctif fondé sur des faits, pas sur des suppositions.

🚀 Installation

Boost s’installe en dépendance de dev (il n’a rien à faire en production) :

composer require laravel/boost --dev
php artisan boost:install

boost:install détecte les agents présents (Claude Code, Cursor, Codex, Gemini CLI, Copilot, Junie…), génère un .mcp.json, un boost.json de configuration, et publie les guidelines et skills adaptées à vos packages installés (Laravel, Livewire, Inertia, Pest, Pint, Filament, Flux, Tailwind…). Pour Claude Code, l’enregistrement est en général automatique ; si besoin :

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

Le serveur MCP est servi par la commande php artisan boost:mcp. Côté .mcp.json, ça donne :

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

L’agent dispose alors d’outils mcp__laravel-boost__* directement dans la conversation. Pour garder les guidelines à jour quand un package évolue, php artisan boost:update (ou boost:update --discover pour scanner les nouveaux packages) suffit.

🧰 Cas d’usage concrets

Trois scénarios où Boost m’a fait gagner du temps récemment.

1. Diagnostiquer une exception en prod-like. Au lieu de jongler entre tail -f, Tinker et le schéma, l’agent enchaîne Last Error → Database Schema → Database Query → Search Docs en une seule conversation. La latence cognitive du contexte switch disparaît.

2. Générer une migration cohérente avec le schéma existant. Via Database Schema, l’agent voit les tables, colonnes, contraintes et indexes actuels. La migration générée respecte les conventions du projet sans qu’on ait à recopier la structure dans le prompt.

3. Proposer une route ou un endpoint en respectant les patterns existants. Couplé aux guidelines Laravel core et aux skills livewire-development / pest-testing installées par Boost, l’agent lit les contrôleurs voisins, comprend les conventions de validation et de réponse, et produit un endpoint qui s’intègre proprement plutôt qu’un copier-coller de tutoriel.

🧠 Combiner Boost avec d’autres outils

C’est sur la combinaison que Boost prend toute sa valeur. Quelques associations efficaces :

• Boost + PAO : Laravel PAO reformate la sortie de PHPUnit, Pest, PHPStan, Rector et Artisan dans un format que l’agent lit nativement. Boost expose l’application, PAO expose les outils, l’agent boucle le cycle “code → test → corrige” sans intermédiaire.
• Boost + Pail : l’agent diagnostique une exception en lisant les logs structurés produits par Pail.
• Boost + MCP data.gouv.fr : Boost gère l’app Laravel, le MCP data.gouv.fr fournit la donnée externe, et l’agent orchestre l’import.
• Boost + GitHub Actions : l’agent ouvre une PR avec la migration ou le job généré, en se basant sur le workflow GitHub Actions déjà en place.
• Boost + Laravel 13 et ses attributs : l’agent suit naturellement la syntaxe attributs décrite dans Laravel 13 quand il génère du code.

⚠️ Quelques précautions

• Boost reste un outil de dev, pas un service exposé. L’install se fait en --dev, et le serveur MCP démarré par boost:mcp ne doit pas tourner en production. C’est l’agent local du développeur qui s’y connecte en stdio.
• Surveiller le contexte transmis. Database Query, Database Schema ou Read Log Entries peuvent renvoyer des données personnelles. Pour les projets sous contraintes RGPD, préférez une base seedée et masquez les colonnes sensibles, ou pointez Boost vers une connexion dédiée.
• Décider quoi versionner. Par défaut, Boost recommande d’ajouter .mcp.json, boost.json, CLAUDE.md, AGENTS.md à votre .gitignore : ces fichiers sont régénérés par boost:install et boost:update. Si vous voulez un comportement déterministe entre développeurs, versionnez plutôt vos guidelines et skills custom dans .ai/guidelines/ et .ai/skills/.
• Tenir Boost à jour. Brancher @php artisan boost:update --ansi dans le post-update-cmd de votre composer.json garantit que les guidelines suivent les versions installées.

🎉 Conclusion

Laravel Boost ne va pas remplacer le développeur, mais il transforme nettement la relation entre l’application Laravel et l’agent IA qui l’accompagne. On passe d’un assistant qui propose du code aveuglément à un assistant qui lit le projet, exécute des requêtes ciblées et produit du code aligné sur la réalité.

Si vous travaillez sur Laravel avec Claude Code, Cursor ou un agent custom, c’est le package qui mérite d’être testé en priorité dans les semaines qui viennent. Et pour fermer la boucle côté outillage (tests, analyse statique, refactor), enchaînez avec Laravel PAO : c’est le complément naturel de Boost pour rendre l’agent vraiment autonome sur un projet PHP.

🔗 Liens utiles

• Dépôt GitHub laravel/boost
• Documentation officielle Laravel Boost
• Documentation Model Context Protocol
• Documentation MCP côté Claude Code
• Agent Skills format