Les agents lisent votre code et les fichiers d'instructions de votre dépôt. Contexte rassemble ces fichiers de mémoire avec les notes de projet, le contexte généré et les références.
Pour connaître la logique sous-jacente à cette organisation, lisez Le contexte de projet dans la section Concepts. Cette page explique comment le gérer.
Fichiers de mémoire du dépôt
Ouvrir Paramètres → Connaissances → Contexte et consultez la section Sources du dépôt. Coroid lit ces fichiers depuis le dépôt connecté :
AGENTS.mdà la racine du dépôt : instructions générales pour les agentsCLAUDE.mdà la racine du dépôt : instructions pour ClaudeGEMINI.mdà la racine du dépôt : instructions pour Gemini.cursor/rules: le fichier de règles Cursor pris en charge
On les appelle souvent des fichiers de mémoire. Leur contenu activé est inclus dans le contexte de projet des agents avant le début du travail. Leurs noms ne les limitent pas à un modèle particulier : les sources activées sont combinées pour les agents de Coroid.
Les fichiers existants s'affichent avec une Éditer action, un compteur de tokens estimé et un sélecteur permettant de contrôler si les agents les reçoivent ou non. Les sources sont activées sauf si vous les désactivez explicitement. Si plusieurs fichiers se répètent ou se contredisent, conservez activées les sources que vous souhaitez voir suivies par les agents et désactivez les autres.
Créer indique que le fichier était absent de la copie de travail du dépôt de Coroid. Si une lecture échoue, la page propose Réessayer; une erreur d'accès ne signifie pas que le fichier est manquant. Vérifiez que le fichier est commité dans la branche du dépôt connecté. Pour l'exécution des tâches, l'agent lit la copie de travail de la tâche, donc les modifications apportées aux fichiers d'instructions sur cette branche s'appliquent à la tâche.
Les fichiers de mémoire activés peuvent importer du Markdown du dépôt avec @path, par exemple
@AGENTS.md dans CLAUDE.md ou @docs/conventions.md. Les chemins sont résolus par rapport au
fichier contenant la référence. Coroid gère les imports imbriqués, arrête les boucles,
et inclut chaque fichier ainsi que chaque corps d'instruction identique une seule fois. Les imports dans les exemples de code et les adresses e-mail ne sont pas traités. Les références externes au dépôt ne sont pas chargées, et les imports ne peuvent pas contourner une source du dépôt explicitement désactivée.
Seules les sources racines listées sont détectées automatiquement. Les fichiers AGENTS.md et
individuels .cursor/rules/*.mdc peuvent être inclus via un @ import ; leur périmètre de répertoire n'est pas inféré automatiquement.
Contextes d'application
Sous Contextes d'application, conservez les instructions et références stockées dans Coroid. Les notes manuelles et le contexte de projet généré peuvent être activés ou désactivés indépendamment des fichiers du dépôt. Utilisez ces entrées pour les informations qui n'appartiennent pas à Git.
Ajouter du contexte
Sélectionnez Ajouter du contexte et ajoutez une entrée. Chacune possède un titre et un corps, et peut être éditée ou supprimée ultérieurement.
De bonnes entrées sont courtes, spécifiques et durables. Les décisions d'architecture, les conventions de style, les contrats API, les limites de propriété et les interdictions explicites en font partie. Le récit d'intégration et tout ce qui est déjà évident à partir du dépôt n'y appartiennent pas.
Gardez les entrées séparées et nommées
Une entrée par sujet, intitulée selon son contenu. « Conventions de gestion des erreurs » et « Modules figés » sont facilement récupérables ; une seule entrée appelée « Notes » contenant les deux ne l'est pas.
Cela est important car le contexte est chargé sélectivement en fonction du travail en cours — voyez Compétences progressives. Des entrées bien séparées permettent de charger la bonne pour la bonne tâche.
Références
En plus des entrées écrites, vous pouvez joindre des références : des liens et des documents qui pointent vers du contenu stocké ailleurs. Utilisez-les lorsque la version officielle se trouve dans une wiki ou un outil de conception et que vous ne souhaitez pas avoir une copie obsolète.
Contexte par tâche
Le contexte du projet s'applique à l'ensemble de son contenu. Pour le matériel pertinent pour une tâche précise — un ticket, un rapport client, un document de conception — attachez-le à cette tâche. Une note spécifique à une tâche laissée dans le contexte du projet devient du bruit pour toutes les tâches ultérieures.
Maintenir l'exactitude
Un contexte obsolète est pire qu'un contexte manquant, car les agents le considèrent comme faisant autorité. Lorsqu'une convention change, mettez à jour l'entrée en même temps que le code.
Examiner ce qui est présent
Lisez votre contexte occasionnellement comme si vous étiez nouveau. Les entrées s'accumulent, et celles rédigées lors d'une migration terminée il y a un an sont désormais trompeuses.