IA Développement

Claude Code et Symfony : l'écosystème qui redéfinit le développement PHP assisté par IA

Article de Javier Eguiluz, AI Skills Symfony UX, Symfony AI Mate : panorama de l'écosystème Claude Code + Symfony en mars 2026.

Alexandre Berge
· · 19 min de lecture ·

En mars 2026, l’écosystème Claude Code + Symfony atteint un point d’inflexion. L’article fondateur de Javier Eguiluz, les AI Skills pour Symfony UX de Simon André, et le lancement de Symfony AI Mate dessinent un écosystème structuré où l’IA cesse d’être un gadget pour devenir un compagnon de développement au quotidien. Panorama complet des ressources, standards et pratiques qui composent cet écosystème en pleine effervescence.

L’article de Javier Eguiluz : le guide de référence

Le 27 février 2026, Javier Eguiluz publie sur dev.to un article intitulé « Claude Code for Symfony and PHP: The Setup That Actually Works ». Évangéliste Symfony, créateur d’EasyAdmin et membre du cœur de l’équipe Symfony, Eguiluz y détaille l’intégralité de son workflow en production. Sa thèse centrale résume l’état de l’art : la différence entre des résultats médiocres et excellents ne tient pas au modèle d’IA utilisé, mais à la qualité de la configuration mise en place.

L’article s’organise autour de sept sections couvrant l’ensemble du workflow de développement. Eguiluz utilise l’abonnement Max (100 dollars par mois) mais précise que le plan Pro (17 dollars par mois) fonctionne également. Il privilégie Claude Code en mode CLI intégré dans PhpStorm via le plugin officiel Anthropic pour JetBrains, ouvert en panneau latéral droit. Pour la sélection de modèle, il recommande Opus 4.6 en effort « High » pour les tâches de planification, accessible via la commande /model.

Les trois enseignements majeurs qu’il met en avant résument sa philosophie minimaliste : (1) écrire un bon fichier AGENTS.md et le raffiner en continu, (2) toujours planifier avant de coder, (3) ne pas surcharger Claude Code de plugins. Il conclut que cette combinaison seule produit de meilleurs résultats que n’importe quel ajustement technique.

Sa configuration globale (~/.claude/settings.json) autorise toutes les commandes bash sûres incluant les outils PHP (php, phpstan, phpunit, php-cs-fixer, symfony), interdit rm et la lecture des fichiers .env et des répertoires de secrets, active le mode acceptEdits par défaut, et active la fonctionnalité expérimentale Agent Teams. Il configure aussi des hooks PostToolUse qui formatent automatiquement les fichiers PHP avec PHP-CS-Fixer, valident les YAML avec lint:yaml et les JSON avec json.tool à chaque écriture ou modification par Claude.

AGENTS.md contre CLAUDE.md : le standard qui s’impose

L’un des débats structurants de l’écosystème concerne le choix entre deux fichiers de configuration pour les agents IA. CLAUDE.md est le fichier propriétaire d’Anthropic, lu par Claude Code au début de chaque session comme une mémoire persistante. Il supporte une hiérarchie de fichiers (dossier home, répertoires parents, racine du projet, sous-répertoires, et .claude/rules/). Les instructions CLAUDE.md sont traitées plus strictement que les prompts utilisateur, comme des règles système immuables.

AGENTS.md est un standard ouvert et indépendant de tout éditeur, formalisé mi-2025 par une collaboration entre OpenAI, Sourcegraph et Google. Il fonctionne avec Claude Code, OpenAI Codex, GitHub Copilot, Gemini CLI, Cursor, Windsurf, Aider, Zed et d’autres. La distinction est limpide : CLAUDE.md ne fonctionne qu’avec Claude, tandis qu’AGENTS.md fonctionne avec tous les outils IA. C’est pourquoi Eguiluz recommande explicitement AGENTS.md pour la portabilité.

Les bonnes pratiques convergent entre les deux formats. Il faut éviter les instructions trop vagues (« Don’t make mistakes ») comme trop spécifiques (« On UserMessageHandler, don’t return early »), et privilégier des règles générales et actionnables. Par exemple : utiliser les conditions Yoda, n’employer que des comparaisons strictes (===, !==), ou recourir systématiquement à la promotion de constructeur pour l’injection de dépendances. Un point critique : le fichier doit inclure les commandes de vérification (phpstan analyse, phpunit, lint:container, php-cs-fixer) pour permettre à l’IA de valider son propre code.

Eguiluz cite le créateur de Claude Code lui-même : l’équipe met à jour en permanence le fichier AGENTS.md de ses projets. C’est la clé pour obtenir de bons résultats. Le fichier AGENTS.md d’EasyAdmin (disponible sur GitHub, branche 5.x) couvre la compatibilité multi-versions Symfony (5.4/6.x/7.x), les conventions de nommage (UpperCamelCase pour les classes, snake_case pour les templates Twig, camelCase pour les variables), les standards de code (Symfony Coding Standards, pas d’autowiring, configuration en PHP), les règles de documentation et l’environnement DDEV.

L’écosystème Symfony adopte activement ces fichiers : les dépôts symfony/ai, symfony/ai-agent, symfony/ai-platform, symfony/ai-bundle et symfony/ai-demo incluent tous des CLAUDE.md et des AGENTS.md.

Plan mode : la discipline qui change tout

Claude Code propose trois modes opératoires aux usages bien distincts. Le mode Normal demande permission avant chaque modification. Le mode Auto-Accept exécute sans demander. Le mode Plan est en lecture seule : Claude peut analyser le codebase, poser des questions, générer un plan détaillé, mais ne peut modifier aucun fichier ni exécuter aucune commande.

L’activation se fait via Shift+Tab (deux pressions pour cycler jusqu’au mode plan), la commande /plan, ou le flag CLI --permission-mode plan. En mode Plan, Claude a accès aux outils de lecture (Read, LS, Glob, Grep, Task, WebFetch, WebSearch), mais pas aux outils d’écriture (Edit, Write, Bash). Un outil dédié exit_plan_mode permet de basculer vers l’implémentation.

Le workflow recommandé par Anthropic et par Eguiluz suit quatre phases : Explorer, Planifier, Implémenter, Committer. Les deux premières phases sont les moins coûteuses en tokens et les plus déterminantes pour la qualité du résultat. Pour les tâches très complexes (impliquant des dizaines de milliers de lignes), passer plus de 30 minutes en planification est rentable. Eguiluz donne un exemple concret de prompt de planification pour les group actions d’EasyAdmin 4.26, incluant des références de fichiers via le préfixe @ pour désigner les templates et composants pertinents.

La gestion de la fenêtre de contexte constitue un enjeu central. La fenêtre de contexte de Claude Code est d’environ 200 000 tokens, mais les prompts système, les définitions d’outils et les fichiers mémoire en consomment 30 000 à 40 000 avant toute interaction. L’auto-compaction se déclenche entre 64 % et 75 % de la capacité. Eguiluz recommande de sélectionner l’option « clear context and auto-accept edits » après finalisation du plan, pour que l’implémentation bénéficie de la fenêtre complète. La commande /clear doit être utilisée systématiquement entre les tâches, et /compact permet de compresser manuellement en préservant des éléments spécifiques. Point important : les fichiers CLAUDE.md et AGENTS.md survivent à la compaction puisqu’ils sont relus depuis le disque après chaque compression.

L’enseignement clé d’Eguiluz pour la gestion des erreurs est simple : corriger un mauvais plan est toujours préférable à corriger du mauvais code. Si les résultats sont systématiquement décevants, le problème se situe dans le plan ou dans l’AGENTS.md, pas dans Claude Code lui-même.

Six plugins essentiels pour le développement Symfony

Le système de plugins de Claude Code fonctionne via des marketplaces, des dépôts Git contenant un fichier marketplace.json et des répertoires de plugins. Deux marketplaces officiels Anthropic coexistent : claude-plugins-official (activé par défaut) et anthropics/claude-code (à ajouter manuellement). La gestion se fait via /plugin (interface interactive) ou en ligne de commande. Un plugin peut contenir des skills (SKILL.md), des agents, des commandes slash, des hooks et des serveurs MCP.

Eguiluz recommande six plugins, avec une philosophie minimaliste qu’il emprunte au créateur de Claude Code : même l’auteur de l’outil n’en utilise pas beaucoup.

php-lsp (Intelephense) est le plugin le plus critique. Il intègre le serveur de langage PHP Intelephense, fournissant la complétion de code, la navigation de définitions, la recherche de symboles et les diagnostics en temps réel. Sans lui, selon Eguiluz, Claude Code n’a aucune compréhension du système de types du projet : il hallucine des noms de méthodes, des arguments et des types de retour. Le plugin offre une amélioration de performance considérable pour la navigation de code (50 millisecondes contre 45 secondes en recherche textuelle). Il nécessite Intelephense installé globalement via npm et Claude Code v2.1.0 ou supérieur.

Context7 (par Upstash) est un serveur MCP qui récupère la documentation à jour et spécifique à la version des bibliothèques (Symfony, Doctrine, Twig, API Platform) directement dans les prompts, éliminant les hallucinations liées à des API obsolètes. L’ajout de « use context7 » dans un prompt ou l’installation du plugin déclenche automatiquement la récupération de documentation.

code-review lance cinq agents Sonnet parallèles pour auditer les pull requests sous différents angles : conformité AGENTS.md, détection de bugs, analyse du contexte git, revue des commentaires PR précédents et vérification des commentaires de code. Chaque finding est noté sur une échelle de 0 à 100 et seuls les problèmes avec un score supérieur ou égal à 80 sont signalés, réduisant drastiquement les faux positifs.

code-simplifier est un agent expert (tournant sur Opus) qui nettoie le code généré par l’IA en préservant la fonctionnalité exacte tout en éliminant la complexité inutile. C’est le même agent utilisé par l’équipe Claude Code d’Anthropic en interne. Open-sourcé le 9 janvier 2026 par Boris Cherny. Des rapports communautaires font état d’une réduction de 20 à 30 % de la consommation de tokens après utilisation régulière.

security-guidance est un hook pre-tool-use qui intercepte les opérations d’écriture et de modification pour avertir des vulnérabilités potentielles (injection de commandes, XSS, désérialisation dangereuse). Il détecte neuf catégories de vulnérabilités et s’exécute de manière transparente sans invocation explicite.

Playwright fournit l’automatisation de navigateur et les tests E2E via le serveur MCP officiel de Microsoft. Pour le développement Symfony, il permet de tester les flux de login, les soumissions de formulaires, les opérations CRUD et les tableaux de bord EasyAdmin, avec détection automatique des serveurs de développement.

Symfony UX AI Skills : la connaissance métier au format standard

Le 6 mars 2026, le blog officiel Symfony publie « Introducing AI Skills for Symfony UX », annonçant des skills créés par Simon André, lead developer chez SensioLabs et membre de l’équipe Symfony UX. Ces skills structurent la connaissance sur le stack frontend Symfony UX pour les agents IA.

Le format SKILL.md est un standard ouvert spécifié sur agentskills.io, créé par Anthropic en décembre 2025, désormais supporté par plus de 27 agents IA (Claude Code, OpenAI Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf). Une skill est un répertoire contenant un fichier SKILL.md avec un frontmatter YAML (nom, description) suivi d’instructions Markdown. Le modèle de chargement suit un principe de divulgation progressive : au premier niveau (environ 100 tokens), l’agent lit uniquement le nom et la description au démarrage. Au deuxième niveau (moins de 5 000 tokens), le corps complet est chargé uniquement quand la skill est activée. Au troisième niveau, les fichiers de référence sont chargés à la demande.

Cinq skills couvrent l’ensemble du stack. symfony-ux est le skill orchestrateur qui contient un arbre de décision pour choisir entre Stimulus, Turbo, TwigComponent et LiveComponent. stimulus couvre les contrôleurs, targets, values, actions, classes, outlets et hooks de cycle de vie, avec des fichiers de référence pour l’API, les patterns et les pièges courants. turbo traite de Turbo Drive, Frames, Streams et de l’intégration Mercure. twig-component documente les props, blocks, computed properties, composants anonymes et la syntaxe HTML. live-component aborde les props, actions, data-model binding, formulaires, emit, defer et lazy loading.

Les skills ciblent Symfony UX 2.22 à 2.28 et au-delà, Symfony 7.2, 7.4 et 8.0, ainsi que PHP 8.4 et supérieur. Elles incluent des alertes de sécurité comme la CVE-2025-47946 sur l’injection ComponentAttributes. Le dépôt fournit des fichiers d’entrée multi-plateformes : CLAUDE.md, AGENTS.md, GEMINI.md et llms.txt.

Un commentaire pertinent sous l’annonce soulève un point intéressant : en utilisant Claude Code Opus 4.6 au quotidien, les agents possèdent déjà une bonne compréhension des packages Symfony UX. Les skills apportent surtout de la valeur sur les cas limites, les arbres de décision et les fonctionnalités spécifiques à certaines versions que l’entraînement général des LLM peut manquer.

Sous-agents et Agent Teams : la parallélisation du travail

Les sous-agents (sub-agents) sont des instances Claude spécialisées qui s’exécutent dans leur propre fenêtre de contexte, préservant ainsi le contexte principal. Chaque sous-agent possède son propre prompt système, son accès à des outils spécifiques et des permissions indépendantes. Ils sont invoqués via l’outil Task et peuvent tourner en arrière-plan (Ctrl+B). Un sous-agent intégré, Explore (propulsé par Haiku), est optimisé pour la recherche en lecture seule dans le codebase. Les sous-agents personnalisés se définissent comme des fichiers Markdown avec frontmatter YAML dans .claude/agents/. Limitation notable : les sous-agents ne peuvent pas créer leurs propres sous-agents (pas d’imbrication possible).

Pour Symfony, Eguiluz souligne un cas d’usage concret : implémenter simultanément un handler Messenger, sa classe de message correspondante et le test fonctionnel, tout en parallèle. La parallélisation peut être forcée en promptant explicitement : « use sub-agents to implement all tasks in parallel ».

Les Agent Teams constituent une fonctionnalité expérimentale qui va plus loin : elle orchestre des équipes d’instances Claude Code séparées travaillant ensemble sur un projet partagé. Un lead coordonne les opérations, les coéquipiers travaillent indépendamment, et la différence cruciale avec les sous-agents tient au fait que les coéquipiers peuvent communiquer directement entre eux, pas seulement remonter au lead. Le système inclut une liste de tâches partagée avec suivi des dépendances, un système de mailbox inter-agents et un mécanisme de verrouillage de fichiers pour éviter les conflits.

L’activation se fait via la variable d’environnement CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1, ce qui débloque les outils TeamCreate, TaskCreate, TaskUpdate, TaskList et SendMessage. La fonctionnalité a été livrée avec Opus 4.6 le 5 février 2026. Le mode Delegate (Shift+Tab en session lead) restreint le lead aux outils de coordination uniquement. Eguiluz active cette fonctionnalité dans sa configuration globale.

Les limitations actuelles sont documentées : pas de reprise de session avec des coéquipiers en cours, un seul team par session, pas de teams imbriqués, et deux coéquipiers modifiant le même fichier créent des conflits d’écriture. Le coût en tokens est élevé puisque chaque coéquipier utilise une fenêtre de contexte complète.

L’écosystème communautaire Symfony + Claude Code

Au-delà des outils officiels, plusieurs projets communautaires enrichissent l’écosystème de manière significative.

superpowers-symfony par MakFly (Kevin Music) est le plugin communautaire le plus complet : 49 skills organisées en 8 catégories (TDD, Doctrine, API Platform, Messenger, CQRS, Sécurité, Qualité, E2E), 13 commandes slash, et un hook SessionStart qui détecte automatiquement les applications Symfony, les environnements Docker (Symfony Docker + FrankenPHP) et les frameworks de test. Il supporte Symfony 6.4 LTS, 7.x et 8.0, avec des niveaux de complexité progressifs pour les exemples.

atournayre/claude-agents par Aurélien Tournayre est une collection Composer d’agents Claude Code spécialisés couvrant les standards PHP, PHPStan, DDD, CQRS et Symfony 6.4, installable via composer require --dev atournayre/claude-agents.

Symfony AI Mate est le composant officiel Symfony fournissant un serveur MCP permettant aux assistants IA d’interagir avec les applications PHP/Symfony. Il offre l’introspection du container de services, l’analyse des logs Monolog et une architecture extensible. L’intégration avec Claude Code se fait en une commande : claude mcp add mate $(pwd)/vendor/bin/mate serve --scope local. C’est un outil de développement uniquement, pas destiné à la production.

symfony/ai-claude-code-platform (v0.6.0, 4 mars 2026) est un pont officiel Symfony AI permettant d’utiliser Claude Code comme plateforme d’inférence dans les applications Symfony AI. Cette intégration toute récente signe l’engagement de Symfony envers Claude Code.

Le paysage PHP/Symfony face aux autres écosystèmes

L’initiative Symfony AI (annoncée par Fabien Potencier le 11 juillet 2025, v0.1.0 le 24 décembre 2025) est l’un des efforts les plus ambitieux d’intégration IA dans un framework serveur. Avec plus de 70 packages, 2 000 commits et 80 contributeurs, elle offre une interface unifiée vers plus de 25 plateformes IA (Platform), un framework d’agents (Agent), le stockage vectoriel pour le RAG (Store), la gestion de conversations (Chat), le serveur MCP (Mate) et l’intégration complète via le bundle AI.

Laravel adopte une approche complémentaire. Laravel Boost (août 2025) fournit un serveur MCP avec plus de 15 outils spécialisés pour l’inspection du codebase, les requêtes base de données et 17 000 éléments de documentation. La différence philosophique est nette : Laravel rend le framework accessible aux agents IA (Boost), Symfony intègre les capacités IA dans les applications (Symfony AI).

Next.js et Vercel mènent la course avec v0 (générateur d’applications IA), des AGENTS.md intégrés, un écosystème de skills et le traitement des agents comme des utilisateurs de première classe. C’est l’écosystème le plus avancé en conception AI-first. Rails adopte une approche communautaire (rails-mcp-server, fast-mcp) sans initiative comparable au niveau du framework. Django bénéficie de la dominance de Python en IA/ML mais n’a pas de framework AI propre intégré.

Les chiffres confirment l’ampleur de l’adoption : 85 % des développeurs utilisent régulièrement des outils IA (JetBrains 2025), dont 68 % des développeurs PHP spécifiquement, avec une augmentation de productivité rapportée d’environ 40 %. Les défis spécifiques à PHP restent le corpus d’entraînement plus restreint que JavaScript ou Python, les bases de code legacy avec peu de type hints, et l’architecture dispersée des fichiers Symfony qui peut dérouter les agents.

Ressources : la boîte à outils complète pour démarrer

L’un des atouts majeurs de cet écosystème est la richesse de ses ressources documentées, testées en production et maintenues par des contributeurs de premier plan. Voici l’inventaire structuré de tout ce qui est nécessaire pour configurer un environnement Claude Code + Symfony opérationnel.

Sources primaires et articles de référence

L’article fondateur de Javier Eguiluz constitue le point d’entrée incontournable :

Documentation officielle Claude Code :

Fichiers de configuration de référence

Plugins Claude Code recommandés

Les six plugins recommandés par Eguiluz, avec leurs pages officielles :

AI Skills Symfony UX

Projets communautaires Symfony

Intégrations MCP Symfony

Documentation Symfony AI

Listes curées et annuaires

Encadré : Checklist de démarrage pour un projet Symfony

(1) Installer Claude Code et le plugin PhpStorm JetBrains. (2) Créer un fichier AGENTS.md à la racine du projet en s’inspirant de celui d’EasyAdmin. (3) Installer les plugins php-lsp, context7 et security-guidance via /plugin dans le CLI. (4) Copier les skills Symfony UX dans ~/.claude/skills/ pour les projets utilisant Stimulus ou Turbo. (5) Configurer ~/.claude/settings.json avec les permissions PHP/Symfony et les hooks PHP-CS-Fixer. (6) Utiliser systématiquement le mode Plan (Shift+Tab) avec Opus 4.6 en effort High pour l’architecture, puis vider le contexte avant l’implémentation.

Conclusion : vers un développement Symfony agent-native

L’écosystème Claude Code + Symfony de mars 2026 n’est plus un assemblage de prototypes mais un workflow cohérent. Le triptyque d’Eguiluz (AGENTS.md, planification, minimalisme des plugins) offre un cadre pratique immédiatement applicable. Les AI Skills de Simon André résolvent le problème de la connaissance métier framework-spécifique avec un standard ouvert multi-agents. Symfony AI Mate crée le pont MCP entre l’application et l’agent. Et les Agent Teams ouvrent la voie à la parallélisation du travail de développement.

La singularité de l’approche Symfony réside dans son architecture de composants appliquée à l’IA. La même philosophie qui a fait le succès du framework pour les applications complexes se déploie désormais dans l’outillage IA. Là où d’autres écosystèmes privilégient la vitesse (Vercel v0) ou l’accessibilité (Laravel Boost), Symfony mise sur la testabilité (InMemoryPlatform), la séparation des responsabilités et l’extensibilité.

Le standard AGENTS.md, en supplantant CLAUDE.md pour sa portabilité multi-agents, illustre un choix d’architecture qui privilégie l’interopérabilité sur le verrouillage fournisseur. Une décision philosophique autant que technique, et parfaitement alignée avec les valeurs du projet Symfony.

La question qui reste ouverte est celle de l’adoption à grande échelle dans les organisations. Les développeurs isolés et les équipes techniques avancées ont déjà franchi le pas. Pour les DSI et les responsables de départements informatiques, le défi est désormais d’intégrer ces pratiques dans les processus existants (revue de code, déploiement continu, gouvernance des outils IA) tout en formant des équipes dont la majorité n’a jamais interagi avec un agent de code autonome. L’écosystème est prêt. La transformation organisationnelle, elle, ne fait que commencer.