Travaillez en duo avec l’IA

Mettez en place une méthode de travail collaboratif avec l’IA

Pour que la collaboration avec un agent IA soit fluide et productive, il faut adopter une méthode structurée.

La méthode la plus efficace est itérative, comme dans un duo humain bien organisé.

Ce cycle crée une collaboration active. Chacun a son rôle :

• Vous, développeur, gardez la vision métier, prenez les décisions, définissez les priorités. Vous êtes le garant de la qualité.

• L’IA vous assiste dans l’exécution, vous fait gagner du temps et vous aide à automatiser.

Cette approche rappelle celle du TDD (Test-Driven Development) : on avance par petites unités de valeur, que l’on valide et affine au fur et à mesure. Plus les étapes sont petites, plus vous gardez la main sur la qualité du code produit.

Un autre avantage de cette méthode est qu’elle vous pousse à réfléchir davantage avant d’écrire du code, ce qui évite l’accumulation de solutions “vite faites” mais mal conçues.

Optimisez votre flow de développement grâce au vibe coding

Le vibe coding, dans sa version maîtrisée, devient un levier considérable pour les développeurs expérimentés. Bien utilisé, il permet de :

• gagner un temps précieux sur les tâches répétitives ou peu stimulantes,

• automatiser les migrations de versions, de syntaxes ou de conventions,

• analyser rapidement du code legacy, même sans documentation,

• expérimenter des librairies encore peu documentées,

• débloquer plus vite des problèmes complexes,

• développer des outils internes beaucoup plus rapidement.

Mais l’IA ne se contente pas d’exécuter. Elle peut devenir un partenaire de développement : elle vous pose des questions, vous aide à structurer vos idées, vous challenge, vous propose des alternatives.

Prenons un exemple :

Vous travaillez sur une refonte partielle de votre interface utilisateur. Vous voulez revoir le système de filtres. Vous tapez votre intention dans votre outil IA :

“Refactoriser les filtres produits en composants réutilisables. Pose-moi des questions avant de commencer”

Au lieu de générer immédiatement du code, l’agent vous demande :

“Quels filtres sont concernés ? Quel est le comportement attendu ? Doivent-ils être synchronisés avec l’URL ?”

Ces questions vous poussent à clarifier votre vision. L’IA ne se contente plus de produire, elle vous aide à mieux concevoir.

Voici quelques formulations utiles à intégrer dans votre routine de prompts pour maximiser la qualité de l’échange :

• “Pose-moi tes questions avant de coder.”

• “Fais-moi un plan détaillé.”

• “Propose plusieurs options si possible.”

• “Revois ta solution et simplifie-la.”

• “Reformule la demande et les contraintes pour confirmer ta compréhension.”

• “Quels sont les risques ou effets de bord ?”

Ces consignes simples encouragent la précision, évitent les dérives, et conduisent à un code plus propre, plus robuste et plus aligné avec votre projet.

Rédigez des règles pour que l’agent soit aligné avec les attendus de votre projet

Une collaboration efficace avec une IA dépend aussi de la façon dont vous la configurez. Un agent IA bien réglé est bien plus utile qu’un outil laissé en mode par défaut.

Le comportement de l’agent peut être largement influencé par des consignes initiales bien formulées. Vous obtiendrez les meilleurs résultats en :

• définissant un rôle clair : mentor, reviewer, pair programmer, senior frontend developer, etc.

• limitant son autonomie : “Ne modifie que les fichiers danssrc/components.” ou paramétrer une liste d’exclusion selon les IDE,

• documentant vos conventions internes,

• fournissant des exemples de code qui représentent le style de votre équipe,

• ajustant le niveau de détails selon le contexte : apprentissage, refacto rapide, travail de fond.

Un agent bien configuré s'aligne davantage avec vos attentes et vos conventions. Il respecte mieux votre contexte, anticipe vos besoins et produit du code plus cohérent avec votre vision du projet.

Quel que soit le format utilisé par votre IDE (AGENTS.md,cursorrules,claude.md,SKILLS.md…), l’objectif reste identique : regrouper les informations essentielles qu’un nouveau collaborateur doit connaître pour travailler correctement sur le projet, sans accompagnement constant.

# Sample AGENTS.md file

## Dev environment tips
- Use `pnpm dlx turbo run where <project_name>` to jump to a package instead of scanning with `ls`.
- Run `pnpm install --filter <project_name>` to add the package to your workspace so Vite, ESLint, and TypeScript can see it.
- Use `pnpm create vite@latest <project_name> -- --template react-ts` to spin up a new React + Vite package with TypeScript checks ready.
- Check the name field inside each package's package.json to confirm the right name—skip the top-level one.

## Testing instructions
- Find the CI plan in the .github/workflows folder.
- Run `pnpm turbo run test --filter <project_name>` to run every check defined for that package.
- From the package root you can just call `pnpm test`. The commit should pass all tests before you merge.
- To focus on one step, add the Vitest pattern: `pnpm vitest run -t "<test name>"`.
- Fix any test or type errors until the whole suite is green.
- After moving files or changing imports, run `pnpm lint --filter <project_name>` to be sure ESLint and TypeScript rules still pass.
- Add or update tests for the code you change, even if nobody asked.

## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committing.

L’objectif de rédiger le contexte de votre projet c’est de décrire les règles du jeu. Il doit contenir :

• une description claire de la structure du projet,

• les étapes pour exécuter, tester et builder,

• les conventions de style et les patterns utilisés,

• des exemples concrets à reproduire,

• une liste d’éléments à ne jamais modifier.

Posez-vous cette question :

“Si je donnais ce fichier à un nouveau développeur, pourrait-il comprendre comment contribuer efficacement ?”

Si la réponse est oui, alors votre IA saura aussi mieux collaborer avec vous.

Gardez à l’esprit que ce fichier est vivant. Vous devez l’ajuster au fil du temps, l’enrichir selon vos besoins, et tester régulièrement ses effets sur la qualité du code produit.

À vous de jouer !

Voici un exercice pour mettre en pratique cette méthode collaborative.

Exercice :

1. Rédigez une première version de votre fichierAGENTS.md pour un projet existant ou fictif. Incluez les éléments suivants :

   • Structure du projet

   • Conventions de nommage

   • Frameworks utilisés et leurs versions

   • Règles de sécurité ou d'accessibilité

   • Éléments à ne pas modifier

2. Choisissez une tâche simple à confier à l’IA : par exemple, ajouter une nouvelle fonctionnalité à une page existante.

3. Donnez votre prompt à l’IA sans fichier  AGENTS.md, et analysez le résultat.

4. Donnez ensuite le même prompt, en fournissant aussi le fichier  AGENTS.md.

5. Comparez les deux versions du code généré :

   • Quels sont les écarts ?

   • La version avec le fichier  AGENTS.md  est-elle plus conforme à vos attentes ?

   • L’IA a-t-elle mieux respecté vos conventions ?

Objectif : expérimenter l’impact d’un bon cadre de collaboration sur la qualité du code généré.

En résumé

• Une méthode de travail itérative avec l’IA permet de garder le contrôle et d’améliorer la qualité du code.

• Le vibe coding structuré permet de gagner du temps tout en maintenant une exigence élevée.

• L’IA peut devenir un véritable partenaire technique si vous l’entraînez à poser les bonnes questions.

• Configurer votre agent (rôle, autonomie, style, conventions) améliore fortement la pertinence des résultats.

• Le fichier  AGENTS.md  est un outil puissant pour aligner l’IA avec les standards et les contraintes de votre projet. Pour en assurer la qualité, demandez-vous si, grâce à ce fichier, un nouveau développeur pourrait comprendre comment contribuer efficacement au projet.

Maintenant que vous savez comment structurer votre collaboration avec l’IA pour produire du code de qualité, il est temps de vous concentrer sur l’essentiel : votre responsabilité, votre esprit critique et la posture professionnelle à adopter face au code généré.