Votre agent dans l'IDE

La règle du jeu

Avant de commencer

• Un compte GitHub, avec Copilot Free activé (github.com › Settings › Copilot).
• VS Code à jour, ou un IDE JetBrains 2026.x.
• L'idée de votre application, en une phrase.
• Facultatif, pour le repli et le bonus : Ollama installé, avec un petit modèle de code déjà téléchargé.

Choisissez votre parcours

Étape 0 · Le dépôt

Créez un dossier pour votre application et ouvrez-le dans l'IDE. Initialisez Git, puis écrivez un README.md de trois lignes, à la main : l'agent n'intervient pas encore.

# [Nom de l'application]

Ce que fait l'outil : [une phrase].
Pour qui : [vous, votre équipe, un usage précis].
Ce qu'il ne fera pas : [ce qui est hors périmètre aujourd'hui].

Étape 1 · Activer l'agent

1. Installez l'extension (VS Code) ou le plugin (JetBrains) GitHub Copilot, puis connectez-vous avec votre compte GitHub.
2. Ouvrez le chat et passez le sélecteur de mode sur Agent.
3. Laissez le modèle sur Auto : l'offre gratuite limite le choix des modèles, et Auto ménage votre quota.
4. Premier test :

Quels outils peux-tu utiliser dans ce projet ? Liste-les, puis dis-moi ce que tu sais déjà de ce dépôt. Ne modifie aucun fichier.

L'agent doit lister ses outils (lecture et écriture de fichiers, recherche, terminal…) et citer votre README.md. S'il ne voit pas le fichier, vérifiez que vous avez ouvert le dossier du projet, et pas un fichier isolé.

Étape 2 · Les modes et les approbations

Vérification : demandez à l'agent « Lance git status » et constatez qu'il vous demande l'autorisation.

Étape 3 · AGENTS.md

AGENTS.md est un format ouvert, lu par Copilot, Junie, Codex et la plupart des agents. Vous l'écrivez une fois, tous les agents en profitent. Remplissez le modèle : vous pouvez demander à l'agent de vous aider, mais c'est vous qui décidez de la stack et des interdits.

# AGENTS.md

## Le projet
[Votre idée en une phrase, reprise du README.]

## Stack
- Langage : [ex. TypeScript 5, Python 3.13]
- Framework : [ex. aucun, Express, FastAPI]
- Tests : [ex. Vitest, pytest]

## Commandes
- Installer : [ex. npm install]
- Tester : [ex. npm test]
- Lancer : [ex. npm run dev]

## Conventions
- [ex. Fonctions courtes, noms en anglais, commentaires en français]
- [ex. Un test pour chaque règle métier]
- [ex. Un commit par étape qui fonctionne]

## Interdits
- Ne jamais ajouter de dépendance sans me le demander.
- Ne jamais écrire de secret (clé, mot de passe, jeton) dans le code.
- Ne jamais modifier un test pour le faire passer.

Vérifiez qu'il est lu : posez une question dont la réponse se trouve dans le fichier.

Quelle commande lance les tests de ce projet, et qu'est-ce que je t'interdis de faire ?

Dans VS Code, ouvrez les références de la réponse : AGENTS.md doit y figurer. Si le plugin JetBrains ne le prend pas en compte, copiez le contenu dans .github/copilot-instructions.md.

Étape 4 · Un serveur MCP

Un serveur MCP donne à l'agent un outil de plus. Choisissez-en un.

Option A · Context7, la documentation à jour

Context7 fournit la documentation actuelle des bibliothèques. L'agent ne se fie plus à ce qu'il a appris à sa date de coupure. Pas de compte nécessaire.

{
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Option B · GitHub, vos dépôts et vos issues

Le serveur MCP officiel de GitHub, hébergé par GitHub. VS Code vous demande de vous connecter à GitHub au premier démarrage : pas de jeton à copier.

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

Dans le sélecteur d'outils du chat, désactivez les outils d'écriture (création d'issue, de PR…) : pour l'atelier, la lecture suffit.

Avec Context7, donne-moi la façon actuelle de [faire une chose précise] avec [une bibliothèque de ma stack]. Cite la version de la documentation utilisée.

Avec GitHub : « Liste mes trois dépôts les plus récents. » Dans les deux cas, l'IDE doit vous demander l'autorisation d'appeler l'outil MCP.

Étape 5 · Le plan

Passez en mode Plan (ou restez en mode Agent : le prompt interdit de coder).

Propose-moi un plan en cinq étapes pour construire cette application. Pour chaque étape : ce qu'on construit, le test qui prouve que ça marche, et les fichiers concernés. Respecte AGENTS.md. Ne code rien.

Relisez le plan avec cette grille :

• La stack est celle d'AGENTS.md, sans dépendance ajoutée en douce.
• Chaque étape a un test, avec votre outil de test.
• Les commandes citées sont les vôtres.
• Rien de ce que le README exclut n'apparaît dans le plan.

Si un point manque, corrigez AGENTS.md plutôt que le prompt, puis redemandez le plan. Enregistrez le plan final dans PLAN.md : l'atelier 2 en repartira.

Étape 6 · Le commit

git add README.md AGENTS.md PLAN.md .vscode/mcp.json
git commit -m "Initialise le projet et la configuration de l'agent"

Sous JetBrains, adaptez le chemin du fichier MCP. Vérifiez qu'aucun jeton ne se trouve dans les fichiers commités.

Critères de réussite

• L'agent tourne dans l'IDE, en mode Agent, et demande l'autorisation avant de lancer une commande.
• AGENTS.md est lu : l'agent cite vos commandes et vos interdits.
• Un outil MCP a été appelé avec succès.
• Le plan en cinq étapes respecte vos instructions.
• Le commit initial contient README.md, AGENTS.md, PLAN.md et la configuration MCP.

En cas de blocage

Le repli local, avec Ollama

1. Installez Ollama, puis un modèle de code qui sait appeler des outils, adapté à votre RAM. Par exemple :

ollama pull qwen2.5-coder:7b

2. VS Code : dans le sélecteur de modèle du chat, « Gérer les modèles », ajoutez le fournisseur Ollama et choisissez le modèle. Il fonctionne en mode Agent si le modèle accepte l'appel d'outils. La complétion reste celle de Copilot.
3. JetBrains : réglages de l'AI Assistant, section des modèles locaux, fournisseur Ollama. Les modèles locaux sont illimités, même sur l'offre gratuite de JetBrains AI.
4. Ou l'extension Continue (VS Code et JetBrains), qui se branche directement sur Ollama.

Un modèle de 7 milliards de paramètres est plus lent et moins fiable qu'un modèle cloud. Il suffit pour terminer l'atelier.

Bonus · Un second agent

L'intitulé officiel de l'atelier parle de plusieurs assistants. Si vous avez fini, branchez-en un deuxième et posez-lui le prompt 4 : les deux plans sont-ils différents ? Lequel respecte le mieux AGENTS.md ?

Autres bonus, sans second agent :

• Un fichier de prompt réutilisable : .github/prompts/plan.prompt.md, avec le prompt 4, appelé par /plan dans le chat (VS Code).
• Un agent personnalisé : .github/agents/relecteur.agent.md, limité aux outils de lecture, qui relit le code sans le modifier (VS Code).