Donner du contexte à un agent CLI

Un agent CLI ne connaît pas votre projet par magie

Sans contexte, un agent CLI doit explorer le code ou les fichiers systèmes à chaque tâche pour comprendre les conventions, l'architecture, les contraintes. Fournir ce contexte à l'avance accélère considérablement le travail.

Le fichier de contexte projet

De nombreux agents CLI supportent un fichier de contexte persistant à la racine du projet (par exemple CLAUDE.md pour Claude Code, ou des mécanismes équivalents pour d'autres outils), décrivant les conventions, la stack technique, les règles à respecter.

# Exemple de fichier de contexte

## Stack
- Serveurs Windows Server 2022, PowerShell 7
- Convention de nommage : PREFIXE-SERVICE-NUMERO

## Règles
- Toujours tester un script sur l'environnement de recette avant production
- Ne jamais modifier directement les GPO en production sans validation

Le contexte de session vs le contexte permanent

• Contexte de session : informations données au fil de la conversation, perdues à la fin de la session.
• Contexte permanent : fichier de contexte relu à chaque nouvelle session, garantissant une cohérence entre les usages successifs.

Cas concret

Une équipe IT utilise un agent CLI pour générer des scripts PowerShell d'administration. Sans fichier de contexte, chaque nouvelle session redemande la convention de nommage des serveurs et les règles de sécurité internes. Avec un fichier de contexte permanent décrivant ces règles une fois pour toutes, chaque script généré respecte automatiquement les conventions, sans avoir à les répéter à chaque interaction.

Erreurs fréquentes

• Répéter le même contexte à chaque nouvelle session au lieu de le formaliser dans un fichier de contexte permanent relu automatiquement.
• Laisser un fichier de contexte devenir obsolète après un changement d'architecture ou de convention, l'agent continuant à appliquer d'anciennes règles.
• Surcharger le fichier de contexte d'informations non pertinentes, diluant les règles réellement importantes dans un volume de texte trop dense.

À retenir

• Un agent CLI explore le contexte manquant à chaque tâche, un coût en temps évitable avec un fichier de contexte permanent.
• Un fichier de contexte projet décrit les conventions et règles à respecter, relu automatiquement à chaque session.
• Un fichier de contexte doit être maintenu à jour, sous peine de faire appliquer des règles obsolètes par l'agent.

Mini-exercice

Une équipe IT redemande systématiquement à son agent CLI la même convention de nommage de serveurs à chaque nouvelle session de travail. Quelle solution élimine cette répétition ?

Réponse : formaliser cette convention dans un fichier de contexte permanent à la racine du projet, relu automatiquement par l'agent à chaque nouvelle session, éliminant le besoin de la repréciser manuellement à chaque fois.