Ingénierie agentique : développer avec des agents IA sans perdre la main

Qu’est-ce que l’ingénierie agentique ?

Un agent de code est plus qu’un chat qui propose des bouts de code. Il travaille directement dans le dossier de votre projet : il lit des fichiers, cherche dans le code, exécute des tests, modifie plusieurs fichiers et vérifie lui-même le résultat. Le développement agentique (agentic coding) décrit ce que fait l’agent. L’ingénierie agentique décrit la discipline qui l’entoure : comment vous rédigez les consignes, rendez les résultats vérifiables et gardez la responsabilité.

Le terme a un parrain connu. En février 2025, Andrej Karpathy, cofondateur d’OpenAI, a forgé l’expression « vibe coding » pour une façon de programmer où l’on s’abandonne complètement aux vibes et oublie jusqu’à l’existence du code. Collins en a fait son mot de l’année 2025. Un an plus tard, en février 2026, Karpathy a désigné « agentic engineering » comme son terme préféré pour la version professionnelle : agentique, parce que la plupart du temps vous n’écrivez plus le code vous-même mais dirigez et supervisez des agents ; ingénierie, parce qu’il y faut du savoir-faire et de l’expérience.

Ingénierie agentique ou vibe coding : la différence

Les deux utilisent les mêmes outils. La différence tient à ce que vous définissez en amont et à la rigueur de la vérification après coup.

Le vibe coding n’est pas une erreur ; c’est un outil pour le bon moment. Beaucoup de vibe coders passent à l’ingénierie dès que l’expérience devient quelque chose que d’autres utilisent.

Vous dirigez : consigne, revue, décision

Avec l’ingénierie agentique, votre travail se déplace. Vous tapez moins de code et faites trois choses avec plus de soin :

• Consigne : vous décrivez ce qui doit être construit et à quoi l’on reconnaît que c’est terminé. Plus la consigne est précise, moins il faut de tours de correction.
• Revue : vous lisez le diff, regardez les résultats des tests et essayez le résultat. Un agent s’arrête quand le travail semble terminé ; seule une revue montre s’il l’est.
• Décision : fusionner ou retravailler, tâche suivante ou changement de cap. Ces décisions vous reviennent.

Les frictions typiques quand on travaille chaque jour avec des agents de code

Si vous travaillez tous les jours avec des agents, vous connaissez ces points :

• Les points ouverts disparaissent dans l’historique du chat. À la fin d’une session, il reste trois choses à faire. Quelques jours plus tard, elles sont enfouies sous de nouveaux messages ou fermées avec la session.
• Les tâches qui vous reviennent se cachent dans de longues réponses. L’agent a besoin d’une clé d’API, d’un enregistrement DNS ou d’une validation dans l’App Store et le mentionne au quatrième paragraphe de son résumé.
• Plusieurs sessions, plusieurs projets. Une fenêtre s’occupe de la page de la formation, une deuxième d’un correctif, une troisième d’une recherche. Vous seul savez où en est chacune.
• Fenêtres de contexte pleines. Les longues sessions rendent les agents moins bons ; c’est pourquoi Anthropic recommande de repartir de zéro avec /clear entre des tâches sans rapport. Ce qui n’est pas dans un fichier est alors perdu pour l’agent.

Les remèdes ont un point commun : l’état du travail a sa place dans des fichiers, pas dans le chat.

En pratique : des workflows Claude Code qui tiennent

Des tâches sous forme de fichiers plutôt que l’historique du chat

Créez chaque tâche sous forme de fichier que l’agent peut lire et modifier : avec un titre, un statut, une attribution et un historique. Chaque nouvelle session commence alors par « Traite tes tâches à faire », et l’agent trouve tout ce dont il a besoin, même après /clear ou dans un autre outil. En fin de session, la consigne est : « Crée des tâches pour les points ouverts. »

Des specs avec critères d’acceptation

Pour tout ce qui dépasse une ligne, vous rédigez une spec : objectif, exigences et critères d’acceptation que vous pouvez cocher. Dans ses bonnes pratiques pour Claude Code, Anthropic conseille, pour les fonctions plus importantes, de laisser l’agent poser des questions et rédiger d’abord une spec, puis de lancer l’implémentation dans une nouvelle session. Une bonne spec nomme les fichiers concernés, dit ce qui est hors périmètre et se termine par une vérification qui montre que tout fonctionne.

Régler le degré d’autonomie : exécuter, brouillon, demander

Toutes les tâches ne supportent pas la même liberté. Mettre à jour une dépendance, l’agent peut simplement le faire. Un texte pour la page d’accueil, il doit le préparer comme brouillon que vous validez. Pour une migration de base de données, il doit d’abord demander. Décidez-le tâche par tâche, pas une fois pour toutes.

Des retours plutôt que des résumés

Quand l’agent a terminé, il ne doit pas seulement répondre, mais vous renvoyer la tâche : pour vérification, avec une note sur ce qu’il a fait et où se trouve le résultat, ou avec une question s’il manque quelque chose. Ce que vous seul pouvez faire, il le crée comme tâche distincte pour vous.

Une revue avec des preuves

Demandez des preuves plutôt que des affirmations : la sortie des tests, la commande exécutée, une capture d’écran. Donnez à l’agent quelque chose qu’il peut vérifier lui-même, comme des tests ou un build. Pour les modifications plus importantes, le mode plan de Claude Code (Shift+Tab) aide : l’agent lit et planifie avant de modifier quoi que ce soit. Et un second regard dans un contexte neuf, par exemple celui d’un sous-agent, trouve les failles que l’agent ne voit pas dans son propre code. Il fait les tâches de code dans sa propre branche ; c’est vous qui décidez de la fusion.

AGENTS.md et CLAUDE.md : le mode d’emploi de votre agent

Chaque session commence sans aucun souvenir de la précédente. Ce que l’agent doit savoir de votre projet va donc dans un fichier qu’il lit au démarrage. AGENTS.md est un format ouvert prévu pour cela, une sorte de README pour agents, aujourd’hui géré par l’Agentic AI Foundation au sein de la Linux Foundation. Codex, Cursor et de nombreux autres outils le lisent. Claude Code lit CLAUDE.md et se rabat sur AGENTS.md en l’absence de CLAUDE.md ; avec @AGENTS.md, vous incluez l’un dans l’autre. Gemini CLI lit GEMINI.md ; le nom du fichier est modifiable.

# AGENTS.md

## Commandes
- Tests : npm test
- Avant de terminer : npm run lint && npm run typecheck

## Règles
- Travaille dans ta propre branche, jamais sur main.
- Pas de push ni de déploiement sans validation.
- Nouvelles dépendances uniquement après avoir demandé.

## Tâches
Les tâches sont dans TandemLoop, lié sous ./tandemloop.
Lis d’abord ./tandemloop/AGENTS.md. Ce dont je dois m’occuper moi-même
(accès, validations, décisions), crée-le là-bas comme tâche pour moi.

Gardez le fichier court. Pour CLAUDE.md, Anthropic recommande moins de 200 lignes et uniquement ce que l’agent ne peut pas lire dans le code lui-même. S’il répète une erreur, la règle a sa place dans le fichier ; s’il suit une règle depuis longtemps, vous pouvez la retirer.

Les outils : Claude Code, Codex, Cursor, Gemini CLI

L’outil que vous choisissez compte moins que votre façon de travailler. Si instructions, specs et tâches sont dans des fichiers, vous pouvez changer d’agent, et le nouveau reprend au même point.

Comment TandemLoop soutient l’ingénierie agentique

TandemLoop est une app de tâches pour Mac, iPad et iPhone dans laquelle vous et votre agent partagez les mêmes tâches. Elles sont enregistrées sous forme de fichiers texte dans votre iCloud Drive ; votre agent les lit et les écrit directement et suit un mode d’emploi fourni par TandemLoop. Aucun plug-in ni aucune API n’est nécessaire.

Plusieurs agents et sessions lisent le même dossier et voient le même état. Un seul devrait écrire à la fois ; sinon, la synchronisation via iCloud peut créer des copies en conflit. La page Une app de tâches pour travailler avec des agents IA présente l’ensemble du workflow ; le guide Claude Code et Obsidian décrit à quoi ressemble la même configuration dans un coffre Obsidian.

Au-delà du code, TandemLoop est une app de tâches complète, avec boîte de réception, projets, échéances et vues personnalisées. Si vous suivez la méthode GTD, laissez l’agent pré-trier la boîte de réception et préparer la revue hebdomadaire.