Aller au-delà de la saisie semi-automatique avec les agents IA

DEV - 09/12
Pourquoi le contexte et les instructions in-repo font la différence entre la « saisie semi-automatique sous stéroïdes » et une ingénierie fiable assistée par l'IA.

Au cours de l’année écoulée, j’ai vu de nombreux ingénieurs logiciels et équipes se lancer dans l’adoption de l’IA, pour ensuite être déçus lorsque le battage médiatique n’apportait guère plus que des astuces de saisie semi-automatique ou la génération de tests unitaires de base. Les résultats ignorent souvent les normes, l’architecture et les conventions, créant ainsi davantage de travail au lieu de le réduire. Plutôt que d’abandonner ce changement inévitable, nous devrions apprendre de ceux qui réussissent.

Que manque-t-il à ceux qui ont du mal à adopter l’IA ? C’est la capacité de guider le modèle avec le contexte. De nombreux outils vous permettent d'injecter automatiquement des instructions personnalisées pour chaque tâche, façonnant ainsi le résultat vers le succès. Dans cet article, je vais vous montrer comment procéder avec GitHub Copilot et Claude Code, vous mettant ainsi sur la voie pour devenir un ingénieur logiciel natif de l'IA.

Pourquoi les instructions changent tout

  • Ils rendent les règles d'équipe implicites explicites et contrôlées par la version.
  • Ils contrôlent les valeurs par défaut de l’agent : style, architecture, dénomination, tests, conventions de validation, garde-fous de sécurité.
  • Ils améliorent la cohérence au sein de l’équipe et réduisent les frictions lors des révisions.
  • Ils ouvrent la porte à davantage d’automatisation de l’IA.

Lorsque les instructions sont stockées dans le dépôt, l'agent les lit comme n'importe quel ingénieur, puis génère par défaut un code qui correspond à vos normes.

Types de fichiers d'instructions : spécifiques à un outil ou universels

Différents outils d'IA prennent en charge différentes conventions de fichiers d'instructions, mais les principes sous-jacents restent les mêmes : fournir un contexte, appliquer des normes et guider le comportement.

GitHub Copilot utilise.github/copilot-instructions.mdpour obtenir des instructions à l’échelle du référentiel qui s’appliquent à toutes les demandes. Pour un contrôle plus granulaire, vous pouvez créer des instructions spécifiques au chemin à l'aide de.github/instructions/*.instructions.mdfichiers avec une portée frontale. Ces fichiers peuvent cibler des chemins, des langues ou des publics spécifiques (IDE ou CLI), ce qui les rend très flexibles pour les projets monorepos et polyglottes.

Claude Code rechercheCLAUDE.mdà la racine de votre projet. Ce fichier unique contient toutes les instructions spécifiques à Claude, bien que vous puissiez organiser des conseils complexes à l'aide de sections et d'en-têtes de démarques.

Approche universelle : de nombreuses équipes adoptentAGENTS.mden tant que convention indépendante de l'outil. Placez unAGENTS.mdfichier à la racine ou imbriqué dans des répertoires, et n'importe quel outil d'agent peut le consommer. Cela fonctionne bien lorsque vous utilisez plusieurs outils d'IA ou que vous souhaitez une source unique de vérité qui n'es...
[Courte citation de 8% de l'article original]