Et si votre outil IA connaissait vos conventions aussi bien qu'un développeur senior de l'équipe ?
Cette question résume l'évolution que beaucoup d'équipes PHP vivent en ce moment avec les assistants IA intégrés à leur workflow. On commence par donner des instructions au coup par coup, on passe aux fichiers de contexte, puis on réalise que la vraie valeur arrive quand l'outil sait déjà ce qu'on attend de lui — sans qu'on ait à le répéter.
C'est exactement le chemin parcouru par Nasrul Hazim, développeur Laravel, et documenté dans son article publié sur DEV Community. Son retour d'expérience illustre une progression qui parle directement aux équipes PHP/Symfony soucieuses de standardiser leur qualité de code.
De agent-skills à claude : pourquoi une architecture à trois couches
Il y a quelques mois, Nasrul avait constitué un dépôt de fichiers SKILL.md — des fichiers texte décrivant ses conventions Laravel (tests avec Pest, classes Action, Livewire 4) pour que Claude Code les intègre dès l'ouverture d'une session. Résultat : fini de ré-expliquer le contexte à chaque fois.
Mais après des mois d'utilisation quotidienne, la limite est apparue : les skills ne suffisent pas à modéliser des workflows complets. Un skill explique comment faire quelque chose. Un agent sait quand et pourquoi l'enchaîner avec autre chose. Une commande, elle, déclenche une action précise à la demande.
Le dépôt a donc été refondu sous le nom nasrulhazim/claude, avec trois couches distinctes :
| Couche |
Rôle |
Quantité (après refonte) |
| Skills |
Conventions et bonnes pratiques |
29 |
| Agents |
Workflows autonomes multi-étapes |
20 |
| Commands |
Actions slash déclenchées manuellement |
10 |
Les fichiers sont installés dans ~/.claude/ avec un sous-dossier par type : skills/, agents/, commands/. Cette séparation n'est pas cosmétique — elle correspond à trois niveaux d'autonomie différents accordés à l'IA.
Ce que ça change concrètement pour une petite équipe
Transposons cela à un contexte Symfony/PHP. Quand on travaille à 3 ou 5 développeurs sur un projet, les problèmes récurrents sont rarement techniques — ils sont de l'ordre de la cohérence :
- Untel écrit les controllers d'une façon, un autre d'une autre.
- Les conventions de nommage des services ne sont pas appliquées uniformément.
- Le nouveau venu passe une semaine à absorber les standards maison.
Une architecture skills/agents/commands adressée à Claude Code permet de coder ces conventions une seule fois, puis de les faire appliquer automatiquement. Concrètement :
Un skill peut décrire la structure attendue d'un service Symfony : où placer la logique métier, comment nommer les exceptions custom, quelle interface implémenter.
Un agent peut prendre en charge la création complète d'un nouveau module : générer l'entité Doctrine, le repository, le service, le controller et les tests associés — en respectant tous les skills définis.
Une commande peut déclencher un audit de cohérence sur un fichier existant : s'il-te-plaît vérifie que ce controller respecte nos conventions.
Le gain en temps de setup est réel, mais le gain en qualité l'est encore plus. L'IA devient un garde-fou vivant plutôt qu'un générateur de code brut.
Intégration dans le scaffolding : la clé de la scalabilité
Un détail important dans l'approche de Nasrul : les skills, agents et commandes sont intégrés directement dans Kickoff, son outil de scaffolding de projets Laravel. Chaque nouveau projet généré depuis Kickoff 1.36.0 embarque d'emblée toute la bibliothèque.
C'est là que l'analogie de l'équipier prend tout son sens. Un développeur senior qui rejoint une équipe apporte ses réflexes. Un outil de scaffolding qui embarque les conventions IA fait la même chose : chaque projet démarre avec un équipier IA déjà formé aux standards maison.
Pour une équipe Symfony, l'équivalent serait d'intégrer cette bibliothèque à votre template de projet (Composer create-project, un dépôt template GitHub, ou un outil interne). Dès le git clone, le contexte IA est prêt.
L'installation reste simple — un script curl ou un plugin dédié — et la mise à jour de la bibliothèque se propage à tous les nouveaux projets sans intervention manuelle.
Conclusion : outiller l'IA, c'est aussi un investissement d'équipe
L'évolution décrite par Nasrul — de skills isolés vers une architecture agents/skills/commands — reflète une maturité croissante dans l'usage des IA de développement. On ne cherche plus à obtenir du code correct parfois, mais à instaurer une cohérence systématique sur toute la base de code.
Pour les équipes PHP/Symfony, la leçon est directement applicable : documentez vos conventions dans des fichiers SKILL.md, modélisez vos workflows récurrents en agents, exposez vos vérifications fréquentes en commandes. Le temps investi à former votre IA à vos standards sera récupéré dès la première semaine — et économisé à chaque nouveau développeur intégré.
L'IA n'est pas là pour remplacer le jugement de l'équipe. Correctement outillée, elle en devient l'amplificateur.
