GUIDE ULTIME DE L'IA

Le Manuel des Agents IA et Orchestrateurs

Agents Autonomes · Orchestration · Exécution · Transformation

DÉMARREZ

Le Manuel des Agents IA et Orchestrateurs est un guide pratique pour comprendre et orchestrer les agents IA.

Conçu pour la découverte, l'apprentissage et la formation · Omninoun.com

2026 — Omninou Cyberwork — Le Manifeste V3

DARK
LIGHT

I — 📜 LE MANUEL DES AGENTS IA ET ORCHESTRATEURS

1. 🚀 Introduction & Vision : L'ère de l'exécution

L'intelligence artificielle ne se résume plus à un simple chatbot qui répond à des questions comme ChatGPT ou Claude. Nous entrons dans l'ère de l'exécution.

⚙️

L'IA devient opérationnelle.

Elle ne conseille plus, elle agit. Nous développons des systèmes capables de prendre des décisions, d'exécuter des tâches complexes et d'apprendre de leurs erreurs.

L'objectif est de libérer l'humain des tâches répétitives pour le concentrer sur la stratégie et la création.

2. 🔍 Le Constat du Marché : Sortir de l'IA isolée

La plupart des entreprises utilisent l'IA de manière isolée : un employé copie-colle un texte dans un LLM, récupère le résultat, et le traite manuellement. C'est une perte de temps et d'efficacité.

Utilisateur
➡️
LLM (Manuel)
➡️
Résultat isolé
⚡ VS ⚡
Workflow Connecté
🔗
Orchestration IA
🔗
ROI Réel

Le véritable ROI de l'IA réside dans l'orchestration et l'automatisation globale des processus via des workflows connectés.

3. 🏗️ Les Piliers Techniques : L'interconnexion

Notre approche repose sur l'interconnexion de quatre piliers technologiques majeurs :

🧠

LLMs

Moteurs de réflexion et de décision stratégique.

🔌

n8n

Orchestration de workflows et flux de données.

📚

RAG

Mémoire long terme et contexte métier ciblé.

🌐

APIs

Connexion aux outils métiers (CRM, ERP, Slack).

4. 💡 Nos Solutions & Actions

Nous déployons des solutions concrètes pour accompagner cette transformation :

🎓 Formations IA & Agents

Monter en compétences les cadres et équipes pour intégrer l'IA dans leur quotidien opérationnel.

🛠️ Générateur avancé de prompts

Un outil interne pour structurer des instructions parfaites et obtenir des résultats optimaux sans hallucination, garantissant la fiabilité des sorties.

🛡️ Le Manifeste d'ingénierie

Notre philosophie : rigueur technique, refus du jargon superficiel, et mise en place d'architectures robustes (Docker, Cloud contrôlé, Souveraineté).

5. 🔄 Transformation Attendue : L'entreprise augmentée

Passer d'une approche réactive à une entreprise augmentée par l'IA.

💎 Valeurs fondamentales

  • Transparence
  • Sécurité
  • Auditabilité
  • Scalabilité

II — COMPRENDRE LE TERRAIN

Avant de choisir un modèle, il faut comprendre qu'il n'existe pas de "meilleur modèle" universel. Il existe des profils adaptés à des usages. Voici la taxonomie qui structure ce guide.

Les 6 profils de modèles IA

1. UI-first — Les créatifs visuels

Ces modèles excellent dans la génération d'interfaces : composants React, Tailwind, animations, landing pages, HTML/CSS propre. Ils ont un bon sens du rythme visuel et produisent du code frontend exploitable rapidement.

Points forts
Vitesse, qualité visuelle, React/Tailwind, responsive design.
Limites
Moins fiables sur l'architecture backend, parfois génériques sur les designs.
Exemples typiques
Gemini Flash, Kimi K2.5

2. Reasoning-first — Les architectes

Ces modèles pensent avant d'agir. Ils décomposent les problèmes, identifient les cas limites, proposent des structures solides. Excellents pour le debugging complexe, la refactorisation, les décisions d'architecture.

Points forts
Logique, debugging, architecture, cohérence sur de longs contextes.
Limites
Parfois plus lents, plus verbeux, moins "créatifs" sur le frontend.
Exemples typiques
Claude Sonnet, GPT-5, GLM-5

3. Agent-first — Les travailleurs autonomes

Ces modèles sont optimisés pour les flux agentiques : tool calling, boucles d'exécution, chaînes de tâches. Ils savent utiliser des outils, s'auto-corriger, et avancer sur plusieurs étapes sans supervision constante.

Points forts
Tool calling, orchestration, pipelines, autonomie.
Limites
Parfois moins fins sur des tâches créatives ou de raisonnement profond ponctuel.
Exemples typiques
DeepSeek V4, Claude (via API), Qwen avec agents

4. Coding-first — Les développeurs fiables

Ces modèles ont été massivement entraînés sur du code. Ils comprennent les nuances des frameworks, produisent du code correct et cohérent, et gèrent bien les projets multi-fichiers.

Points forts
Fullstack, Backend API, APIs, TypeScript, React Native.
Exemples typiques
Gemini Flash, Qwen 3.6 Plus, Claude Sonnet

5. Low-cost — Les workers économiques

Ces modèles offrent un rapport qualité/coût exceptionnel. Parfaits pour les tâches répétitives, les pipelines à fort volume, les agents secondaires, le préprocessing de données.

Points forts
Coût très bas, vitesse, bon niveau général.
Exemples typiques
DeepSeek, Gemini Flash, Claude Haiku

6. Long-context — Les lecteurs de gros documents

Ces modèles gèrent des contextes de plusieurs centaines de milliers de tokens. Indispensables pour analyser de grandes bases de code, des documents longs, ou maintenir une cohérence sur de très longues sessions.

Points forts
Contexte étendu, cohérence sur sessions longues.
Exemples typiques
Gemini (1M tokens), Claude (200k tokens)

Comment évaluer un modèle : les 5 axes

Pour chaque modèle ou cas d'usage, évalue-le sur ces 5 axes :

Axe Ce que ça mesure Questions à se poser
Vitesse Rapidité de génération Est-ce que j'ai besoin de résultats immédiats ?
Profondeur Qualité du raisonnement Le problème est-il complexe ou simple ?
Coût Prix par token/requête Quelle est la fréquence d'utilisation ?
Autonomie Capacité agentique Doit-il agir seul ou juste répondre ?
Créativité Originalité des sorties Est-ce un travail créatif ou technique ?

Les 3 pièges classiques

1. Le modèle unique

Utiliser le même modèle pour tout — parce que c'est simple, parce que c'est ce qu'on connaît — c'est le piège le plus courant. C'est aussi le plus coûteux et le moins efficace à terme.

Utiliser GPT-5 pour générer du CSS simple, c'est comme prendre un taxi pour aller chercher le pain.

2. Le benchmark aveugle

Les benchmarks mesurent des performances dans des conditions contrôlées. Ils ne mesurent pas ce qui compte : la qualité sur ta tâche précise, dans ton contexte, avec tes contraintes. Le meilleur modèle, c'est celui qui finit ton travail vite, proprement, avec peu de retries.

3. Le "plus cher = meilleur"

Faux. Les modèles low-cost modernes (Gemini Flash, DeepSeek, Haiku) font 80% du travail d'un modèle premium pour 10% du prix. La vraie compétence est de savoir quand payer pour la puissance et quand économiser.

II — 🤖 Annuaire des Agents IA & Écosystèmes

Une cartographie technique et structurée des outils, environnements et protocoles qui définissent l'ingénierie logicielle et l'automatisation basées sur les agents autonomes.

1. 🛠️ Agents IA de Développement

Systèmes d'exécution autonomes interagissant directement avec le cycle de vie du code (IDE, CLI, environnements sandboxing et Git).

Agent Description Technique Lien Officiel
Claude Code Agent CLI natif d'Anthropic s'exécutant localement dans le terminal. Capable de lire la base de code, d'exécuter des tests, de gérer Git et d'exploiter les serveurs MCP. Visiter Site
OpenAI Codex CLI Interface en ligne de commande exploitant les modèles Codex/GPT pour la traduction de commandes naturelles en scripts exécutables. Visiter Site
Gemini CLI Outil en ligne de commande permettant d'interagir directement avec l'API Gemini pour des tâches de refactoring et d'analyse de code à large contexte. Visiter Site
Cursor Agent Mode agent avancé intégré à l'IDE Cursor, capable de planifier et d'appliquer des modifications multi-fichiers de manière autonome. Visiter Site
Windsurf IDE de type "Agent-native" orchestrant des flux de travail collaboratifs en temps réel entre le développeur et l'agent (Cascade). Visiter Site
Aider Assistant de programmation en ligne de commande optimisé pour Git, permettant d'éditer du code dans des dépôts existants avec un suivi strict des commits. Visiter Site
Goose Agent open source agnostique (Block/Agentic AI Foundation). S'exécute directement sur la machine (CLI/Desktop) pour automatiser des recettes de build ou de refactoring sans friction Docker. Visiter Site
OpenHands (Successeur d'OpenDevin). Plateforme open source permettant à des agents logiciels autonomes de modifier du code et d'exécuter des commandes dans un sandbox Docker sécurisé. Visiter Site
Amp Agent de codage développé par Sourcegraph, tirant parti de leur moteur d'intelligence de code globale et d'indexation sémantique des dépôts. Visiter Site
Freebuff Alternative communautaire open source axée sur la modification de bases de code locales. Visiter Site
Codebuff Assistant spécialisé dans la navigation, la refactorisation et la réécriture de projets logiciels à grande échelle. Visiter Site
Pi Coding Agent Agent autonome récent conçu pour la résolution de tickets d'architecture complexes et la génération de tests unitaires. Visiter Site

2. 🏢 Environnements de Travail IA

Espaces de travail et IDE cloud où les agents collaborent de manière synchrone ou asynchrone avec l'utilisateur.

  • Claude Cowork : Espace collaboratif d'Anthropic conçu pour aligner plusieurs instances de modèles sur la réalisation d'objectifs métiers ou techniques d'équipe. → Lien
  • Microsoft 365 Copilot : Intégration de l'écosystème d'agents de Microsoft au sein du Graph d'entreprise pour l'automatisation des flux documentaires et de communication. → Lien
  • ChatGPT (Mode Agent) : Fonctionnalités avancées de traitement asynchrone et d'appels d'outils systémiques dans l'interface d'OpenAI. → Lien
  • Perplexity Labs : Environnement d'expérimentation et d'évaluation pour la recherche d'informations en temps réel et le grounding de données. → Lien
  • Manus : Agent d'interface généraliste capable de naviguer de manière autonome sur le Web, de manipuler des applications tierces et de délivrer des projets de bout en bout en arrière-plan. → Lien
  • Lovable : Constructeur d'applications full-stack (Vibe Coding) générant le code, l'interface et l'infrastructure à partir de descriptions en langage naturel. → Lien
  • Bolt.new : Environnement de développement web en sandbox dans le navigateur, permettant de concevoir, d'exécuter et de déployer des applications full-stack basées sur Vite et Node. → Lien
  • Replit : Plateforme cloud intégrant des agents d'édition et de déploiement natifs pour passer instantanément du prompt à l'application en production. → Lien

3. ⚙️ Orchestrateurs d’Agents

Frameworks de haut niveau gérant la distribution des tâches, la mémoire et la collaboration multi-agents.

  • OpenClaw : Solution open source d'orchestration permettant de déployer, configurer et coupler efficacement des agents autonomes à des canaux tiers (ex: Telegram, API REST). → Lien
  • Hermes Agent : Agent de traitement avancé orienté vers la gestion autonome des tâches de fond et l'interaction outillée standardisée. → Lien
  • CrewAI : Framework d'orchestration basé sur des rôles spécifiques (agents, tâches, outils) permettant de simuler des équipes d'ingénierie ou opérationnelles. → Lien
  • LangGraph : Extension de LangChain permettant de modéliser les flux d'agents sous forme de graphes cycliques, indispensable pour les comportements itératifs complexes. → Lien
  • AutoGen : Framework de Microsoft facilitant le développement de systèmes multi-agents capables de converser entre eux pour résoudre des problèmes. → Lien
  • Semantic Kernel : SDK open source de Microsoft permettant d'intégrer des LLM à des langages conventionnels comme C#, Python et Java. → Lien
  • PydanticAI : Cadre d'application de type-safe pour la construction d'agents de production, garantissant la validation stricte des structures de données via Pydantic. → Lien
  • Smolagents : Framework ultra-léger développé par Hugging Face, centré sur la simplicité et l'écriture de code Python natif par l'agent pour exécuter ses actions. → Lien

4. 🌐 Agents Web

Agents spécialisés dans l'interaction avec le DOM, la navigation et l'automatisation des processus Web à la place de l'humain.

  • OpenAI Operator : Agent autonome conçu pour prendre le contrôle du navigateur ou du système afin d'exécuter des workflows complexes à la demande. → Lien
  • Browser Use : Framework Python permettant de connecter n'importe quel LLM à un navigateur Chromium pour une interaction sémantique avec les éléments d'une page web. → Lien
  • Skyvern : Solution utilisant la vision par ordinateur et le LLM pour automatiser les flux de travail sur des sites Web complexes ou sans API, remplaçant le scraping traditionnel. → Lien
  • Stagehand : Framework d'automatisation de navigateur open source bâti sur Playwright, optimisé pour des actions robustes guidées par l'IA. → Lien
  • Browserbase : Plateforme d'infrastructure cloud pour exécuter, gérer et surveiller des flottes de navigateurs headless dédiés aux agents IA. → Lien
  • Steel Browser : Navigateur cloud managé et optimisé pour les agents IA, incluant la gestion intégrée des empreintes de navigation et des proxies. → Lien

5. 🔄 Automatisation & Workflows

Plateformes d'intégration connectant les LLM et les agents aux bases de données et aux API tierces via des architectures de pipelines.

  • n8n : Plateforme d'automatisation de workflows low-code / native-code dotée de nœuds IA avancés. Idéale pour connecter PostgreSQL, des bases vectorielles et des architectures de traitement asynchrone de données. → Lien
  • Make : Outil d'automatisation visuel permettant de construire des scénarios d'intégration d'API et de routage de données textuelles. → Lien
  • Zapier : Solution grand public pour l'interconnexion rapide d'applications SaaS avec des fonctionnalités d'appels d'agents de base. → Lien
  • Flowise : Interface utilisateur UI low-code permettant de concevoir et d'héberger des applications basées sur LangChain et des architectures de type RAG. → Lien
  • Dify : Plateforme de développement d'applications LLM unifiée, combinant la gestion des prompts, du RAG (Retrieval-Augmented Generation) et de l'orchestration opérationnelle. → Lien
  • Langflow : Environnement visuel de prototypage rapide pour les architectures IA basées sur des composants modulaires réutilisables. → Lien

6. 🧠 Frameworks de Construction d'Agents

Librairies et SDK fondamentaux pour le développement d'architectures cognitives sur-mesure.

  • LangChain : Le framework pionnier pour l'assemblage de composants d'intelligence artificielle, de chaînes de traitement et de connecteurs d'outils. → Lien
  • LlamaIndex : Framework spécialisé dans l'ingestion, l'indexation et la requétabilité efficace de structures de données hétérogènes par les LLM. → Lien
  • DSPy : Framework de programmation déclarative remplaçant le prompt engineering manuel par un processus d'optimisation algorithmique des prompts et des poids des modèles. → Lien
  • Haystack : Framework open source d'orchestration IA, hautement modulaire, conçu pour bâtir des systèmes RAG et de recherche sémantique personnalisés. → Lien
  • Agno : Framework de développement orienté vers la création d'agents robustes avec gestion d'état native et support multi-modèles. → Lien
  • Mastra : Framework TypeScript/JavaScript moderne pensé pour intégrer facilement des fonctionnalités agentiques et de gestion de workflows dans les applications Node.js/Frontend Framework. → Lien
  • Atomic Agents : Approche de développement modulaire et atomique, favorisant la création d'outils et de sous-agents hautement prévisibles et réutilisables. → Lien

7. 📡 Protocoles d’Interopérabilité

La couche standardisée indispensable à la communication structurée entre agents, serveurs et clients.

Protocole Rôle Technique Importance / Maturité
MCP (Model Context Protocol) Standard ouvert développé par Anthropic reliant les modèles à des sources de données sécurisées (GitHub, Slack, bases SQL, environnements Docker) via une API unifiée. ⭐⭐⭐⭐⭐
A2A (Agent-to-Agent) Spécification émergente permettant le routage des messages, la délégation de sous-tâches et la négociation de contextes entre systèmes autonomes distincts. ⭐⭐⭐⭐⭐
ACP (Agent Communication Protocol) Standard ouvert de messagerie inter-agents, assurant le formatage et l'intégrité des communications distribuées. ⭐⭐⭐⭐
OpenAPI Specification Description formelle des endpoints d'API REST permettant aux agents de générer dynamiquement des requêtes HTTP sans intervention humaine. ⭐⭐⭐⭐
JSON Schema Définition stricte des structures de données (Input/Output). Crucial pour contraindre le Structured Output des modèles et éviter les erreurs d'analyse de type. ⭐⭐⭐⭐
OAuth 2.0 Framework de délégation d'autorisation, garantissant que les agents accèdent de manière sécurisée aux ressources tierces au nom de l'utilisateur. ⭐⭐⭐⭐
SSE (Server-Sent Events) Protocole de streaming unidirectionnel permettant de recevoir en temps réel les flux de tokens (token streaming) et les logs d'exécution des agents. ⭐⭐⭐
WebSocket Canal de communication bidirectionnel persistant pour la synchronisation d'état en temps réel et la collaboration synchrone multi-agents. ⭐⭐⭐

8. 📚 Ressources Utiles

  • Prompts : Répertoires de configurations de contextes system et de techniques d'optimisation structurées (ex : approches déconstruction/diagnostic).
  • Templates : Squelettes de code pré-configurés pour initialiser rapidement des architectures multi-agents ou des serveurs MCP.
  • llms.txt : Fichier de configuration standardisé à la racine des sites web servant à fournir un contexte sémantique propre et directement assimilable par les crawlers des agents IA.
  • Benchmarks : Protocoles de tests et métriques de performance (SWE-bench, GAIA) évaluant la capacité de résolution de problèmes réels par les agents.
  • Tutoriels : Documentations techniques et guides d'implémentation d'automatisation de processus de données et de pipelines d'ingénierie.

V — LA PENSÉE AGENTIQUE

Qu'est-ce qu'un agent ? (Pas la définition marketing)

Le mot "agent" est partout. Il est souvent mal utilisé. Voici la définition qui compte opérationnellement :

Un agent IA, c'est un modèle qui peut prendre des actions dans le monde réel — appeler des APIs, lire des fichiers, écrire du code, naviguer sur le web, envoyer des messages — et enchaîner ces actions de façon autonome pour atteindre un objectif.

Ce qui distingue un agent d'un simple chatbot :

  • Il a accès à des outils (tools / function calling)
  • Il peut agir en plusieurs étapes sans intervention humaine à chaque étape
  • Il peut s'auto-corriger en fonction des résultats intermédiaires
  • Il maintient un état et une mémoire sur la durée d'une tâche

Un agent ne "répond" pas — il "fait".

Orchestration vs Exécution : la distinction fondamentale

La confusion la plus fréquente dans les projets IA est de mélanger deux rôles qui doivent rester séparés :

Orchestration Exécution
Décide quoi faire Fait ce qui est décidé
Choisit le bon agent pour chaque tâche Exécute une tâche précise
Gère les erreurs et redirige Remonte les erreurs
Maintient la vision globale Maintient la focus locale
Modèles : Claude Sonnet, GPT-5 Modèles : DeepSeek, Haiku, Gemini Flash

L'erreur classique : utiliser un modèle puissant et coûteux pour l'exécution de tâches simples. Résultat : facture qui explose, latence inutile, aucun gain de qualité.

La bonne approche : modèle léger pour l'exécution, modèle intelligent pour l'orchestration — et l'humain pour la supervision finale.

Les nouveaux flux de travail agentiques

Flux 1 — La décomposition de tâche

Avant de lancer quoi que ce soit, tu décomposes. Exemple pratique :

Objectif : "Créer une page de profil utilisateur avec photo, bio, et historique d'activité"

  1. Designer la structure des données (modèle Backend API) → Qwen
  2. Créer les endpoints API → Qwen
  3. Générer le composant React principal → Gemini Flash
  4. Créer les sous-composants (photo, bio, historique) → Gemini Flash
  5. Intégrer et tester la cohérence → GLM-5 ou Claude Sonnet

Chaque étape est claire, assignable, vérifiable. C'est ça la décomposition agentique.

Flux 2 — Le routing intelligent

Le routing, c'est la décision en temps réel : "Pour cette tâche précise, quel modèle ?"

Les critères de routing :

  • Complexité de la tâche (simple → Haiku/Flash ; complexe → Sonnet)
  • Type de tâche (UI → Kimi/Gemini ; backend → Qwen ; debug → GLM-5)
  • Coût acceptable (tâche répétitive → low-cost ; tâche critique → premium)
  • Vitesse requise (temps réel → Flash ; réflexion → Sonnet)

Un bon système de routing peut automatiser ces décisions. Mais même manuellement, développer ce réflexe change tout.

Flux 3 — La boucle de feedback

Les agents ne font pas tout bien du premier coup. La force est dans la boucle :

  1. L'agent produit un résultat
  2. Tu (ou un autre agent) évalues le résultat
  3. Si satisfaisant : on passe à l'étape suivante
  4. Si insatisfaisant : on corrige le prompt, on relance, ou on change de modèle

Cette boucle court-circuite le modèle mental "j'envoie un prompt et j'espère". Elle remplace l'espoir par du contrôle.

Flux 4 — La mémoire de contexte

Un problème majeur des agents : ils oublient. La plupart des modèles n'ont pas de mémoire persistante entre les sessions.

Solutions pratiques :

  • Passer le contexte pertinent à chaque appel ("voici où on en est")
  • Maintenir un fichier d'état que l'agent peut lire et mettre à jour
  • Utiliser des outils de mémoire (bases vectorielles, résumés automatiques)
  • Structurer les sessions courtes avec des checkpoints explicites

L'humain dans la boucle : quand superviser, quand lâcher

La supervision humaine a un coût : ton temps et ton attention. Il faut la réserver aux moments où elle a de la valeur.

Superviser activement Laisser tourner
Décisions irréversibles Tâches répétitives et testées
Première exécution d'un flux Pipelines stables avec logs
Sorties publiques ou client Preprocessing interne
Gros montants / données sensibles Classification / extraction basse valeur
Nouveaux agents / outils Agents déjà validés sur des centaines de cas

La règle d'or : supervise jusqu'à ce que tu aies confiance. Lâche dès que tu as des métriques de qualité fiables.

Les anti-patterns agentiques : les erreurs à ne pas faire

Anti-pattern 1 — Trop d'autonomie trop tôt

Donner à un agent l'accès à des systèmes critiques avant d'avoir validé son comportement sur des cas simples. Résultat : des actions irréversibles mal exécutées.

Règle : commence toujours en mode "lecture seule", puis accorde les permissions progressivement.

Anti-pattern 2 — Contexte mal géré

Lancer un agent sur une longue tâche sans lui passer l'historique pertinent. Il "oublie" le début, produit des sorties incohérentes.

Règle : toujours inclure le contexte minimum nécessaire — ni trop (pollution du contexte) ni trop peu (perte de cohérence).

Anti-pattern 3 — Coût qui explose

Utiliser un modèle premium pour toutes les étapes d'un pipeline, y compris les plus simples. Résultat : facture ×10 sans gain de qualité.

Règle : profiler chaque étape, assigner le modèle le moins cher qui fait bien le travail.

Anti-pattern 4 — Prompt trop vague

"Fais quelque chose d'intéressant avec ces données." Les agents ne gèrent pas l'ambiguïté aussi bien qu'un humain. Résultat : sorties aléatoires, retries en boucle.

Règle : sois aussi précis qu'avec un collaborateur junior — format attendu, contraintes, exemples si possible.

Anti-pattern 5 — Pas de gestion d'erreur

Un pipeline qui ne prévoit pas ce qui se passe quand un agent échoue. Il plante, rien ne continue.

Règle : toujours prévoir un fallback — un autre modèle, une sortie dégradée, une alerte humaine.

V — 💭 LA PENSÉE AGENTIQUE

Pour passer de la théorie à la production sans obstacle, l'implémentation de la pensée agentique sur ta machine (via vos fichiers de configuration comme CLAUDE.md ou .clauderc) doit suivre un protocole strict en 6 étapes. Ce workflow transforme un simple chatbot en un ingénieur logiciel autonome et fiable.

1. Plan Node Default (Mode Planification)

Avant toute modification, l'agent s'isole dans un nœud de planification. Il cartographie l'arborescence, inspecte les dépendances et liste les fichiers impactés. Un plan d'action écrit est produit et soumis à validation avant exécution.

Avant d'écrire ou de modifier la moindre ligne de code, tu dois obligatoirement ouvrir une phase de planification. 
Analyse l'arborescence existante, lis les fichiers nécessaires et rédige un plan d'action structuré sous forme de liste. 
Attends ma validation explicite avant de passer à l'exécution.

2. Subagent Strategy (Stratégie de Sous-Agents)

Pour éviter la surcharge de contexte, l'agent principal délègue à des sous-agents spécialisés. Chaque sous-agent gère une tâche ciblée (tests, parsing, UI), garantissant précision et modularité.

Pour toute tâche complexe impliquant plus de 3 fichiers ou des technologies distinctes (ex: Frontend + Backend), 
comporte-toi comme un orchestrateur. Décompose le travail et génère des instructions ultra-ciblées (des micro-prompts) 
pour guider tes sous-agents ou tes propres itérations futures de manière isolée.

3. Self-Improvement Loop (Boucle d'Auto-Amélioration)

L'agent relit et critique son propre code avant de le soumettre. Il recherche failles de sécurité, duplications, complexité inutile et typages manquants. Les corrections sont appliquées automatiquement dans cette boucle courte.

Une fois le code écrit, applique une relecture critique automatique avant de me le présenter. 
Analyse ta propre proposition à la recherche de : failles de sécurité, duplication (DRY), complexité inutile (KISS) et typages manquants. 
Corrige tes propres erreurs de manière invisible dans cette phase.

4. Verification Before Done (Vérification Systématique)

Une tâche n'est validée qu'après exécution des tests unitaires et du build de production. Sans succès complet, la tâche reste ouverte.

Tu as l'interdiction formelle de déclarer une tâche comme terminée ou de me demander de tester si tu n'as pas toi-même exécuté 
les tests du projet et le build de production dans le terminal. 
Le succès de ces commandes est le seul critère de validation acceptable.

5. Demand Elegance (Exigence d'Élégance Équilibrée)

Le code doit rester simple, robuste et lisible. Pas de sur-ingénierie ni de frameworks lourds si une solution native suffit. L'élégance prime sur la complexité gratuite.

Recherche constamment l'élégance et la simplicité architecturale. 
Ne propose jamais de sur-ingénierie (over-engineering) ou de frameworks lourds si une solution native ou simple convient. 
Le code doit être minimal, moderne, documenté sur le 'pourquoi' et lisible par un humain.

6. Autonomous Bug Fixing (Correction Autonome)

En cas d'échec des tests ou du build, l'agent analyse les logs, isole le bug et propose une correction. Il relance la boucle de modification sans solliciter l'humain, sauf blocage persistant.

Si une commande de test ou de build échoue à l'étape 4, n'interromps pas ton exécution pour me demander de l'aide. 
Analyse immédiatement les logs d'erreur du terminal, localise la ligne défaillante, émets une nouvelle hypothèse 
et corrige le tir de manière autonome.

VI — NIVEAUX DE LECTURE

Ce guide est conçu pour être lu et relu à mesure que tu progresses. Voici comment l'aborder selon ton niveau actuel.

🟢 Niveau Débutant — Par où commencer

Tu découvres les modèles IA ou tu viens de commencer à les utiliser dans ton workflow.

Ce qu'il faut retenir

  • Il n'existe pas un seul "meilleur modèle" — il existe des modèles adaptés à des usages
  • Commence avec Gemini 2.5 Flash pour la majorité de tes tâches de coding
  • Ajoute Qwen 3.6 Plus dès que tu travailles sur du backend Python/Backend API
  • Utilise Claude Sonnet quand tu es bloqué sur quelque chose de vraiment difficile

Le setup minimal pour démarrer

  • Gemini Flash → ton modèle quotidien par défaut
  • Qwen → ton modèle backend
  • Un modèle premium (Claude Sonnet ou GPT-5) → ton filet de sécurité

Ce que tu n'as pas encore besoin de comprendre

  • L'orchestration multi-agents — ça viendra plus tard
  • Le routing automatique — commence par le faire manuellement
  • Les pipelines complexes — d'abord valide les cas simples

🟡 Niveau Intermédiaire — Combiner les modèles

Tu utilises déjà plusieurs modèles mais de façon intuitive, pas encore systématique.

Ce qu'il faut intégrer

  • Développer le réflexe "quel modèle pour cette tâche précise" avant chaque session
  • Appliquer les patterns de stack (IV) plutôt que de choisir au cas par cas
  • Commencer à décomposer les grandes tâches en sous-tâches assignables
  • Mettre en place des boucles de feedback courtes

Les compétences clés à développer

  • Écrire des prompts précis avec contexte, format attendu, et contraintes
  • Reconnaître quand un modèle doit être changé (résultats décevants → change de modèle)
  • Gérer le contexte manuellement entre les sessions

Premier agent à construire

Un agent simple qui prend une spécification de composant React, la décompose en étapes, et génère chaque partie avec le bon modèle. Rien de complexe — mais ça force à penser en flux.

🔴 Niveau Avancé — Orchestration et architectures

Tu maîtrises les bases et tu veux construire des systèmes agentiques robustes.

Ce qu'il faut construire

  • Un système de routing automatique basé sur le type et la complexité de la tâche
  • Des pipelines avec gestion d'erreur, fallbacks, et logs
  • Une couche de mémoire persistante (base vectorielle ou fichier d'état structuré)
  • Des métriques de qualité automatisées pour évaluer les sorties d'agents

Les architectures à explorer

  • Hierarchical agents : un orchestrateur + des workers spécialisés
  • Parallel agents : plusieurs agents sur des sous-tâches indépendantes en simultané
  • Self-correcting agents : boucle de validation intégrée dans chaque agent
  • Human-in-the-loop : points de supervision automatiquement déclenchés sur les cas incertains

La question centrale à ce niveau

Comment construire un système qui reste fiable à mesure qu'il gagne en autonomie ? La réponse : tests, métriques, logs, et supervision progressive.

Table de progression

Niveau Compétence principale Setup type Prochaine étape
🟢 Débutant Choisir le bon modèle par usage Gemini + Qwen + 1 premium Appliquer un pattern de stack
🟡 Intermédiaire Combiner les modèles, décomposer les tâches Stack SaaS ou Low-cost Construire un premier agent simple
🔴 Avancé Orchestration, routing, pipelines robustes Setup Elite Économique Architecture multi-agents avec métriques

ANNEXES

A. Glossaire

Les termes clés de ce guide, définis sans jargon inutile.

Agent IA
Modèle IA capable de prendre des actions autonomes dans le monde réel en utilisant des outils, d'enchaîner plusieurs étapes, et de s'auto-corriger.
Context window (fenêtre de contexte)
La quantité maximale de texte qu'un modèle peut traiter en une seule fois. Un contexte de 1M tokens peut analyser un roman entier d'un coup. Important pour les longs projets.
Fine-tuning
Processus d'entraînement supplémentaire d'un modèle sur des données spécifiques pour améliorer ses performances sur un domaine précis.
Hallucination
Quand un modèle produit une information fausse avec confiance. Fréquent sur des faits précis, des dates, des noms. À toujours vérifier sur les contenus critiques.
Orchestration
La coordination de plusieurs agents ou modèles pour accomplir une tâche complexe. L'orchestrateur décide qui fait quoi, dans quel ordre.
RAG (Retrieval-Augmented Generation)
Technique qui permet à un modèle d'aller chercher de l'information dans une base de données avant de répondre. Réduit les hallucinations et permet d'utiliser des données récentes.
Routing
La décision d'envoyer une tâche à tel ou tel modèle selon ses caractéristiques. Peut être manuel (tu décides) ou automatique (un système décide).
System prompt
Instruction donnée au modèle en amont de la conversation pour définir son rôle, son ton, et ses contraintes. Très puissant pour personnaliser le comportement.
Temperature
Paramètre qui contrôle le niveau de créativité/aléatoire du modèle. 0 = déterministe et prévisible. 1+ = créatif et varié. Pour du code : garder bas. Pour de la créativité : monter.
Token
L'unité de base que les modèles traitent. Environ 0,75 mots en français. Le coût des modèles est calculé en tokens. 1000 tokens ≈ 750 mots.
Tool calling (function calling)
Capacité d'un modèle à appeler des fonctions ou APIs externes — chercher sur le web, lire un fichier, envoyer un email. La brique fondamentale des agents.

B. Tableau de décision rapide

Pour choisir rapidement le bon modèle selon la situation :

Situation Modèle recommandé Raison
Composant React/Frontend Framework standard Gemini Flash Vitesse + qualité frontend
Modèle Backend API complexe Qwen 3.6 Plus Excellent Python/ORM
Bug inexplicable GLM-5 ou Claude Sonnet Raisonnement profond
Landing page créative Kimi K2.5 Créativité visuelle
Pipeline automatisé DeepSeek V4 Coût ultra-bas, tool calling
Petite correction CSS Claude Haiku Rapide et cheap
Architecture système critique Claude Sonnet / GPT-5 Intelligence maximale
Session longue (100k+ tokens) Gemini ou Claude Gros contexte
Refactoring massif multi-fichiers Claude Sonnet Cohérence sur grand contexte
Test/classification à volume DeepSeek ou Haiku Volume + coût

C. Ce guide est vivant

Le marché des modèles IA évolue vite. Un modèle recommandé aujourd'hui peut être dépassé dans six mois. Un nouveau compétiteur peut émerger du jour au lendemain.

Ce guide doit être mis à jour régulièrement. Les principes (pensée agentique, orchestration, routing, patterns de stack) restent stables. Les recommandations de modèles spécifiques évoluent.

Traite-le comme un système vivant : note tes propres observations, ajoute tes cas d'usage, invalide ce qui ne correspond plus à ta réalité.

Le meilleur guide est celui que tu adaptes à ta réalité.