Kit de configuration pour agents de code : Codex et Claude Code

Utilise des consignes claires dans un dépôt avec Codex, Claude Code ou les deux. Ce kit gratuit t'aide à donner à l'agent les faits utiles sur le projet, à définir un changement borné et à vérifier le résultat sans lui déléguer ton jugement.

Il s'adresse aux développeurs qui savent lire du code et veulent rendre leur configuration réutilisable dans un dépôt qu'ils connaissent déjà. Ce sont des fichiers à adapter, pas un installateur ni une formation.

Ce que contient le téléchargement

• Un modèle commun AGENTS.md, en français et en anglais. Décris le but du dépôt, sa stack, ses dossiers importants, les limites de travail et les contrôles qualité vérifiés.
• Un adaptateur CLAUDE.md facultatif, dans les deux langues. Il importe les consignes partagées dans les configurations Claude Code qui en ont besoin. Codex utilise AGENTS.md comme consignes de projet.
• Une checklist de premier lancement, en français et en anglais. Installe les fichiers sans écraser l'existant, vérifie le contexte chargé par chaque outil et essaie une petite tâche réversible.
• Un brief de tâche, dans les deux langues. Note le comportement observé, le résultat attendu, les critères d'acceptation, les limites et les contrôles avant l'implémentation.
• Une fiche de vérification, dans les deux langues. Relie chaque critère à un test ou une observation, relis le diff complet et précise les limites des preuves obtenues.
• Trois consignes réutilisables, en français et en anglais. Explorer le dépôt, réaliser un changement borné et accepté, puis vérifier et relire le résultat.

L'archive contient uniquement des fichiers Markdown. Elle n'installe aucun logiciel, ne contient pas de hooks exécutables, ne modifie pas les permissions et n'active aucune connexion externe.

Installer le kit dans un dépôt que tu connais

1. Décompresse le ZIP dans un dossier temporaire et choisis un dossier de langue.
2. Vérifie si la racine du dépôt contient déjà AGENTS.md ou CLAUDE.md. Ne les écrase pas. Compare les fichiers, fusionne toi-même uniquement les sections utiles et garde une copie récupérable.
3. Si AGENTS.md n'existe pas, copie le modèle à la racine. Si tu utilises Claude Code et que CLAUDE.md n'existe pas, copie l'adaptateur à côté.
4. Remplace les champs entre crochets par des faits confirmés dans le dépôt. Vérifie les commandes dans les scripts, la documentation ou la CI; supprime ce que tu ne peux pas confirmer ou dont tu n'as pas besoin.
5. Ouvre une nouvelle session dans chaque outil et demande-lui de résumer les consignes sans modifier de fichier. Compare le résumé au projet réel.
6. Utilise le brief pour cadrer une petite tâche réversible. Relis le plan proposé avant de demander l'implémentation.
7. Après le changement, remplis la fiche de vérification. Relis le diff toi-même et note ce que les tests n'ont pas établi.

Ce qui est commun et ce qui dépend de l'outil

Le kit rassemble les faits du projet et les limites de travail dans un AGENTS.md commun. Codex lit ce fichier comme consigne de dépôt. Le comportement de la mémoire de projet Claude Code peut dépendre de la version et de la configuration; l'adaptateur CLAUDE.md fourni importe le fichier commun lorsque c'est la configuration dont tu as besoin. Vérifie les deux outils dans une nouvelle session au lieu de supposer que les mêmes noms de fichiers produisent le même comportement.

Garde les permissions de chaque outil séparées des consignes du dépôt. Le kit n'accorde aucun accès terminal, réseau, fichier ou MCP et n'active aucune approbation automatique. AGENTS.md fournit un contexte, ce n'est pas un mécanisme de contrôle d'accès. Un agent peut mal comprendre ou ignorer une consigne : relis ses changements et vérifie le résultat.

Une consigne en lecture seule pour vérifier le setup

Après avoir copié et adapté les fichiers, essaie ceci dans une nouvelle session avant toute modification de code :

Lis les consignes du dépôt qui s'appliquent à sa racine. Résume le but du projet, les commandes de vérification, une consigne dont tu n'es pas sûr et ce que tu ne dois pas faire. Ne modifie aucun fichier.

Si le résumé invente une commande ou décrit mal le projet, corrige les consignes avant de continuer. Cette vérification sert justement à repérer un mauvais modèle avant que l'agent touche au code.

Ce que le kit ne contient pas

Ce kit n'installe aucun agent de code, ne fournit pas de profil de permissions préconfiguré, n'embarque pas de hooks ou de MCP, n'audite pas ton dépôt privé et ne garantit pas que l'agent produira un code correct. Il ne comprend ni accompagnement en direct ni implémentation personnalisée. Tu gardes la responsabilité des accès accordés, de la revue du code et du niveau de preuve suffisant.

Ne mets jamais d'identifiants, de données client, d'informations de production ou d'URL privée dans les consignes ou prompts partagés. Utilise des exemples fictifs si une tâche a besoin de données. Si ton dépôt contient déjà des règles, conserve-les et résous les conflits délibérément.

Documentation officielle

• Consignes de projet Codex
• Mémoire de projet et imports Claude Code