Context Engineering pour le développement assisté par IA : analyse comparative de cinq plateformes

Les outils de développement assisté par IA ont convergé vers le context engineering — l'art de structurer instructions, mémoire et capacités agentiques pour guider le comportement du modèle de manière déterministe et reproductible. Claude Code, Cursor, GitHub Copilot, Mistral (Vibe/Code) et Google Antigravity proposent chacun une architecture distincte, mais des patterns communs émergent : fichiers Markdown d'instructions, système de skills modulaires, support MCP universel, et modes agentiques autonomes.

Cette analyse technique détaille les mécanismes internes de chaque outil et propose des stratégies concrètes d'interopérabilité pour les développeurs qui alternent entre plusieurs plateformes en 2026.

---

Architecture des fichiers de contexte : cinq approches, un même objectif

Chaque outil utilise une hiérarchie de fichiers Markdown pour injecter des instructions persistantes dans le contexte du modèle. Les différences résident dans la granularité, la syntaxe et les mécanismes d'activation.

Claude Code (Anthropic)

Claude Code implémente un système à quatre niveaux avec précédence décroissante qui permet une gestion granulaire du contexte :

Les fichiers CLAUDE.md sont chargés automatiquement dans le system prompt à chaque session. Claude traverse récursivement l'arborescence depuis le répertoire courant vers la racine, chargeant chaque CLAUDE.md rencontré — un atout majeur pour les monorepos.

Bonne pratique 2026 : Selon HumanLayer et Builder.io, votre CLAUDE.md devrait contenir moins de 300 lignes et privilégier les références (file:ligne) plutôt que les copies de code.

Les fichiers dans les sous-répertoires sont chargés à la demande quand Claude accède à ces répertoires. Le système d'import @path/to/file permet l'inclusion récursive (max 5 niveaux). La commande /init génère un CLAUDE.md initial en analysant le projet.

Fichiers complémentaires :

• .claude/settings.json (hooks, permissions)
• .mcp.json (serveurs MCP)
• .claude/agents/*.md (sous-agents personnalisés)
• .claude/commands/*.md (commandes slash)
• .claude/skills/*/SKILL.md (skills)
• .claudeignore (exclusions)

Cursor

Cursor a connu trois générations de systèmes de contexte. Il est essentiel de distinguer ce qui est actuel de ce qui est déprécié :

.cursorrules (legacy — ⚠️ déprécié). Ce fichier unique à la racine du projet est officiellement marqué comme déprécié dans la documentation officielle Cursor. Cursor recommande explicitement de migrer vers Project Rules (.cursor/rules/) ou vers AGENTS.md. Le fichier reste fonctionnel par rétrocompatibilité mais ne recevra plus de support.

.cursor/rules/*.mdc (format actuel, toujours supporté). Le format MDC (Markdown avec frontmatter YAML) est le système de règles principal. Chaque fichier .mdc possède un frontmatter qui détermine son mode d'activation :

Point subtil documenté dans le code source : si alwaysApply: true est défini, les globs sont ignorés — la règle s'applique systématiquement. Une règle avec uniquement globs: ne sera attachée que si un fichier correspondant est actuellement ouvert ou référencé dans la session.

Depuis Cursor 2.2 (décembre 2025), les nouvelles règles sont créées sous forme de dossiers dans .cursor/rules/ plutôt que de fichiers .mdc individuels, pour améliorer la lisibilité et la maintenabilité. Les fichiers .mdc existants continuent de fonctionner.

La hiérarchie de précédence est : Team Rules (dashboard entreprise, peuvent être "enforced") > Project Rules (.cursor/rules/) > User Rules (Cursor Settings > General > Rules for AI) > Legacy .cursorrules (déprécié).

Cursor supporte également AGENTS.md — un fichier Markdown simple sans frontmatter, compatible avec Claude Code, placé à la racine ou dans des sous-répertoires. C'est l'alternative recommandée par Cursor pour les cas simples ne nécessitant pas le système de métadonnées des .mdc.

Fonctionnalités complémentaires :

• Composer (modèle de coding propriétaire) et interface agent-centric pour gérer plusieurs agents en parallèle

Recommandation communauté 2026 : La communauté Cursor valide qu'une vingtaine de fichiers courts (< 50 lignes chacun) est plus efficace qu'un seul fichier monolithique. Préférer le type "Agent Requested" au type "Always" pour économiser le contexte.

GitHub Copilot

Copilot propose le système de scoping le plus granulaire avec trois niveaux d'instructions :

Les fichiers *.instructions.md utilisent un frontmatter YAML avec un champ applyTo pour cibler des types de fichiers spécifiques — une approche élégante pour les projets multi-langages.

Fichiers complémentaires :

• .github/agents.md (directives pour le coding agent)
• copilot-setup-steps.yml (workflow d'environnement)
• .github/chatmodes/*.chatmode.md (modes personnalisés)
• .github/prompts/*.prompt.md (prompts réutilisables)
• .github/skills/[name]/SKILL.md (skills agent)

Auto Model Selection (GA décembre 2025) : Copilot choisit intelligemment le modèle optimal selon le type de tâche, avec un système de premium requests à multiplicateur variable (Gemini Flash = 0.25x, Claude Opus = 10x).

Mistral (Vibe CLI / Mistral Code)

Mistral Vibe CLI utilise un système orienté configuration TOML plutôt que Markdown pur :

Le dossier .vibe/ contient :

• config.toml (projet ou ~/.vibe/config.toml pour global)
• Prompts système personnalisés dans ~/.vibe/prompts/*.md
• Skills dans ~/.vibe/skills/*/SKILL.md

Le système de trust folder demande confirmation à l'entrée d'un répertoire avec un .vibe/.

Mistral Code (extension IDE entreprise) n'a pas d'équivalent direct aux fichiers d'instructions Markdown — le contexte est géré via les commandes @ (Current File, Open Files, Git Diff, Terminal, Problems).

Google Antigravity

Antigravity utilise le répertoire .agent/ avec quatre mécanismes distincts :

La distinction entre Rules (passifs, toujours actifs), Workflows (actifs, déclenchés par l'utilisateur) et Skills (déclenchés sémantiquement par l'agent) est la plus explicite parmi tous les outils analysés.

Le Progressive Disclosure des skills — chargement à la demande et libération après usage — est un mécanisme unique pour éviter la saturation du contexte.

---

Skills, agents et hooks : les mécanismes avancés d'extensibilité

Le format SKILL.md comme standard émergent

Un pattern remarquable émerge : Claude Code, GitHub Copilot et Google Antigravity utilisent tous le format SKILL.md avec frontmatter YAML + instructions Markdown. La structure de base est commune :

---
name: nom-du-skill
description: Description pour le déclenchement sémantique
---
# Instructions
Étapes détaillées pour l'agent...

Chez Claude Code, les skills sont des packages modulaires avec fichiers de référence optionnels, limités à 2% du contexte window. L'option context: fork permet l'exécution en sous-agent isolé.

Chez Copilot, les skills résident dans .github/skills/[name]/ et fonctionnent cross-plateforme (VS Code, CLI, coding agent).

Chez Antigravity, les skills utilisent le déclenchement sémantique — l'agent matche automatiquement l'intention contre les descriptions et charge uniquement les skills pertinents.

Insight Vercel 2026 : Selon Vercel, un AGENTS.md compressé de 8KB atteint un taux de réussite de 100%, tandis que les skills plafonnent à 79% même avec instructions explicites. AGENTS.md est dans le system prompt à chaque tour, le rendant plus fiable pour un contexte cohérent.

Bonnes pratiques skills 2026

Selon Anthropic's best practices et Gend.co :

• Utiliser la forme gérondive (verb + -ing) pour les noms de skills : "DebuggingComplexIssues" plutôt que "DebugComplexIssues"
• Workflow de développement : Travailler avec une instance Claude ("Claude A") pour créer un skill utilisé par d'autres instances ("Claude B")
• Hot-reloading (Claude Code 2.1) : sauvegarder le fichier met à jour immédiatement le skill dans la session active

Hooks : le contrôle déterministe

Seuls Claude Code et GitHub Copilot proposent des systèmes de hooks complets.

Claude Code offre 10 événements :

• PreToolUse, PostToolUse
• PermissionRequest
• UserPromptSubmit
• Notification
• Stop, SubagentStop
• PreCompact
• SessionStart, SessionEnd

Communication via JSON stdin, codes de sortie (0 = succès, 2 = bloquer), et matchers par pattern. Configuration dans .claude/settings.json.

GitHub Copilot propose des hooks sur :

• sessionStart
• sessionEnd
• userPromptSubmitted

Pour validation, logging et automatisation.

Google Antigravity utilise un système de policies de permissions (terminal, navigateur, revue de code) plutôt que des hooks programmatiques.

Sous-agents et exécution parallèle

Les Background Agents de Cursor (v0.50) et le Coding Agent de Copilot représentent une avancée significative : ils exécutent des tâches end-to-end de façon asynchrone, créant branches et pull requests sans intervention humaine.

Cursor 2.0 a renforcé ce concept avec son interface agent-centric : un layout dédié où agents, plans et runs sont des objets first-class, permettant de gérer plusieurs agents en parallèle.

L'Agent Manager d'Antigravity pousse le concept plus loin avec une interface dédiée de type « Mission Control » pour orchestrer plusieurs agents simultanément.

---

Modèles et fenêtre de contexte : le nerf de la guerre

Google Antigravity détient la plus grande fenêtre de contexte avec 2M tokens via Gemini 3 Pro, un avantage considérable pour l'analyse de codebases complexes.

Mistral offre 256K tokens sur Codestral/Devstral, spécifiquement optimisés pour le code.

Claude Code propose 200K en standard avec des options d'extension jusqu'à ~1M tokens.

La compaction automatique (Claude Code, Cursor) et le chargement progressif (Antigravity skills) sont les principales stratégies de gestion du contexte long.

GitHub Copilot se distingue par son auto model selection (GA décembre 2025) : le système choisit intelligemment le modèle optimal selon le type de tâche.

---

Support MCP : un protocole universel adopté par tous

Le Model Context Protocol (MCP) est devenu le standard d'interopérabilité de facto. Annoncé par Anthropic en novembre 2024, MCP a été donné à l'Agentic AI Foundation (AAIF) en décembre 2025, une initiative co-fondée par Anthropic, Block et OpenAI.

Les cinq outils supportent MCP, avec des niveaux de maturité variables :

Point critique 2026 : Selon la documentation MCP officielle, trop de serveurs MCP dégradent le contexte effectif. Claude Code documente explicitement que 200K tokens peuvent chuter à ~70K avec de nombreux outils activés. Il est recommandé de désactiver les serveurs MCP inutilisés via disabledMcpServers.

SDKs officiels disponibles en 2026 :

• Python, TypeScript, C#, Java
• Go (maintenu en collaboration avec Google)
• Swift

Adoption en 2026 : Les IDE, plateformes de coding (Replit) et outils d'intelligence de code (Sourcegraph) ont massivement adopté MCP pour donner aux assistants IA un accès temps réel au contexte projet.

---

Stratégies d'interopérabilité entre outils

Pour les développeurs utilisant plusieurs outils en parallèle, trois vecteurs de compatibilité existent :

1. AGENTS.md — le fichier cross-tool le plus portable

Supporté nativement par Claude Code et Cursor (qui le recommande comme alternative au .cursorrules déprécié), c'est un fichier Markdown simple sans frontmatter, placé à la racine du projet ou dans des sous-répertoires.

Il fonctionne comme une instruction « always-on » dans les deux outils. Pour les projets multi-outils, AGENTS.md est le meilleur point d'entrée commun : les conventions de codage, l'architecture du projet et les standards d'équipe y trouvent leur place naturelle.

2. SKILL.md — format partagé entre trois outils

Claude Code (.claude/skills/), GitHub Copilot (.github/skills/) et Google Antigravity (.agent/skills/) utilisent le même format SKILL.md avec frontmatter YAML. Les champs name et description sont universels.

Il est envisageable de maintenir un répertoire canonique de skills et de les symlinkier vers les emplacements spécifiques de chaque outil, bien que les champs de frontmatter avancés diffèrent. Cursor peut aussi importer des Claude skills directement.

3. MCP — interopérabilité universelle via le protocole

Un même serveur MCP (mémoire, GitHub, Notion, base de données) fonctionne avec tous les outils. La configuration diffère (JSON dans .mcp.json pour Claude Code, .cursor/mcp.json pour Cursor, .vscode/mcp.json pour Copilot, TOML pour Vibe, JSON pour Antigravity), mais les serveurs eux-mêmes sont identiques.

Un script de synchronisation peut générer les fichiers de configuration spécifiques à partir d'une source unique.

Stratégie recommandée pour un contexte unifié

1. Créer un AGENTS.md à la racine avec les conventions universelles du projet (architecture, standards de code, commandes build/test)
2. Maintenir les fichiers spécifiques par outil (CLAUDE.md, .cursor/rules/*.mdc, .github/copilot-instructions.md) pour les instructions qui exploitent les capacités propres à chaque plateforme
3. Utiliser un script de synchronisation MCP qui génère les fichiers de configuration par outil depuis une source canonique
4. Placer les skills dans un répertoire partagé avec des symlinks vers .claude/skills/, .github/skills/ et .agent/skills/
5. Gitignorer les fichiers locaux/personnels (.local.md, settings.local.json) tout en committant les fichiers partagés

---

Tableau comparatif synthétique

---

Conclusion : choisir sa stratégie de context engineering

Le paysage du context engineering est en consolidation rapide autour de trois standards de facto : les fichiers Markdown d'instructions (avec variantes de nommage), le format SKILL.md pour les capacités modulaires, et MCP pour l'intégration d'outils externes.

La différenciation se joue désormais sur les mécanismes avancés :

• Hooks déterministes (avantage Claude Code)
• Activation conditionnelle par globs et Agent Requested (avantage Cursor)
• Orchestration multi-agents (avantage Antigravity)
• Modèles spécialisés open-weight (avantage Mistral)

Pour les développeurs seniors jonglant entre plusieurs outils

La stratégie optimale consiste à investir dans les couches d'abstraction partagées :

• AGENTS.md pour les conventions
• SKILL.md pour les workflows réutilisables
• MCP pour les intégrations

Tout en exploitant les capacités uniques de chaque plateforme via leurs fichiers spécifiques. Le coût de maintenance de cette approche multi-couches est compensé par la portabilité et la résilience face à l'évolution rapide de l'écosystème.

Google Antigravity : le nouvel entrant à surveiller

Fait notable : Google Antigravity, bien que le plus récent (novembre 2025), propose l'architecture de context engineering la plus explicitement structurée avec sa séparation Rules/Workflows/Skills.

Son adoption rapide est à surveiller de près, d'autant que sa période de preview gratuite avec Gemini 3 Pro en fait un outil immédiatement accessible.

---

FAQ — Questions fréquentes sur le context engineering

Quel fichier de contexte utiliser pour un nouveau projet multi-outil ?

Commencez par un fichier AGENTS.md à la racine du projet. C'est le format le plus portable, supporté nativement par Claude Code et Cursor. Il fonctionne comme une instruction "always-on" et permet de définir les conventions universelles (architecture, standards de code, commandes build/test) sans dépendre d'un outil spécifique.

Quelle est la différence entre .cursorrules et .cursor/rules/*.mdc ?

.cursorrules est officiellement déprécié depuis la documentation Cursor. Migrez vers .cursor/rules/*.mdc (format MDC avec frontmatter YAML) ou vers AGENTS.md. Les fichiers .mdc offrent un contrôle granulaire sur l'activation (always, globs, agent-requested, manual) et une meilleure maintenabilité via des fichiers modulaires.

Combien de serveurs MCP puis-je activer sans dégrader les performances ?

Cursor limite à 40 tools max, GitHub Copilot à 128 tools max. Claude Code documente que 200K tokens peuvent chuter à ~70K avec de nombreux outils activés. Recommandation : n'activez que les serveurs MCP dont vous avez réellement besoin, et utilisez disabledMcpServers pour les autres.

Comment faire cohabiter plusieurs fichiers de contexte (CLAUDE.md, AGENTS.md, etc.) ?

Les outils respectent une hiérarchie de précédence. Pour Claude Code : Enterprise > Projet > Utilisateur > Local. Pour Cursor : Team Rules > Project Rules > User Rules > Legacy. Évitez les doublons d'instructions entre fichiers — utilisez AGENTS.md pour les conventions universelles et les fichiers spécifiques (CLAUDE.md, .mdc) pour les capacités avancées propres à chaque outil.

Les skills SKILL.md sont-ils portables entre Claude Code, Copilot et Antigravity ?

Oui, partiellement. Les trois outils utilisent le même format de base (frontmatter YAML + Markdown). Les champs name et description sont universels. Les champs avancés (ex: context: fork chez Claude Code) sont spécifiques. Vous pouvez maintenir un répertoire canonique de skills et les symlinkier vers .claude/skills/, .github/skills/ et .agent/skills/.

---

Chez Hoko, nous accompagnons les équipes techniques dans l'adoption de l'agentic coding et du context engineering. Notre Bootcamp Agentic Coding de 3 jours vous forme aux meilleures pratiques de Claude Code, Cursor et MCP pour multiplier votre vélocité par 5 à 10x.

Besoin d'un audit de votre configuration de context engineering ? Contactez-nous pour un premier échange gratuit de 30 minutes avec nos experts.

---

Sources

• HumanLayer - Writing a good CLAUDE.md
• Builder.io - The Complete Guide to CLAUDE.md
• Gend.co - Claude Skills and CLAUDE.md: a practical 2026 guide for teams
• Cursor Documentation - Context Rules
• GitHub Copilot Features
• Vercel - AGENTS.md outperforms skills in our agent evals
• Anthropic - Skill authoring best practices
• Model Context Protocol Specification
• Anthropic - Introducing the Model Context Protocol
• DigitalOcean - GitHub Copilot vs Cursor 2026