Développer avec des agents IA sur Laravel et Statamic : Laravel Boost et MCP

J'utilise de plus en plus d'agents IA pour coder : Claude Code dans le terminal, Junie dans PhpStorm et parfois OpenCode. Un souci revient souvent : l'agent ne connaît pas le projet. Il propose une config Tailwind v3 alors que le projet est en v4, ou du Blade alors que le site tourne sous Antlers.

Laravel Boost corrige une bonne partie de ces erreurs. Voici comment je l'utilise sur ce site, qui tourne sous Statamic 6 et Laravel 13.

1. Installer Laravel Boost

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

L'installation demande quels agents vous utilisez, puis crée trois choses :

• un fichier de guidelines (AGENTS.md) qui décrit le projet à l'agent, en tenant compte des versions installées dans votre composer.json ;

• un fichier .mcp.json qui déclare le serveur MCP de Boost ;

• des skills, c'est-à-dire des instructions spécialisées (bonnes pratiques Laravel, tests, Tailwind, Debugbar) que l'agent charge quand il en a besoin.

Le .mcp.json de ce site ressemble à ça :

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

Boost garde vos choix dans un boost.json :

{
    "agents": ["junie", "claude_code", "opencode"],
    "guidelines": true,
    "mcp": true,
    "packages": ["statamic/cms", "chrisvasey/statamic-boost", "barryvdh/laravel-debugbar"],
    "skills": [
        "laravel-best-practices",
        "testing-best-practices",
        "tailwindcss-development",
        "debug-using-debugbar"
    ]
}

Après une mise à jour de vos dépendances, relancez cette commande pour que les guidelines suivent :

php artisan boost:update

2. Ce que le serveur MCP apporte

MCP (Model Context Protocol) permet à l'agent d'appeler des outils fournis par votre application. Ceux que j'utilise le plus avec Boost :

• search-docs cherche dans la documentation qui correspond à vos versions ;

• database-schema et database-query lisent la structure de la base et exécutent des requêtes en lecture ;

• browser-logs récupère les erreurs JavaScript du navigateur ;

• get-absolute-url donne la bonne URL locale du projet, pratique avec Valet ou Herd.

Il y a aussi des outils pour lire les logs Laravel et la dernière erreur. L'agent va chercher l'information au lieu de deviner, et la différence se voit vite.

3. Statamic Boost

Pour les sites Statamic, j'ajoute Statamic Boost, une extension développée par la communauté :

composer require chrisvasey/statamic-boost --dev
php please statamic-boost:install

Elle ajoute des guidelines propres à Statamic et des outils MCP pour lister les collections, blueprints, globals, navigations, taxonomies, formulaires et conteneurs d'assets, lire les entrées d'une collection ou chercher dans la documentation Statamic. Je n'ai plus besoin d'expliquer à l'agent quels champs existent : il va les lire dans les blueprints.

4. Les règles que je m'impose

Boost aide beaucoup, mais je garde quelques habitudes :

• je demande d'abord un plan, je le corrige, et seulement ensuite le code ;

• avant une grosse modification, je fais écrire des tests. Pour une refonte, par exemple, un test qui vérifie que chaque page du site répond toujours ;

• je relis chaque diff et je committe par petites étapes ;

• l'agent ne modifie pas les dépendances sans mon accord. La règle est écrite dans les guidelines du projet ;

• je vérifie le résultat dans le navigateur, sur desktop et sur mobile ;

• je ne mets jamais de clé d'API ni de mot de passe dans un prompt.

Conclusion

Laravel Boost s'installe en deux commandes et règle la plupart des erreurs liées au contexte : mauvaises versions, mauvais moteur de templates, champs inventés. Avec Statamic Boost et quelques tests, c'est le setup que j'utilise sur ce site. Sa refonte a d'ailleurs été faite comme ça.