Les agents lisent votre code. Contexte est l'endroit où vous placez ce que le code ne peut pas exprimer — les décisions, contraintes et conventions qui existent en dehors de celui-ci.
Pour comprendre pourquoi ces éléments appartiennent ici, lisez Le contexte du projet dans la section Concepts. Cette page explique comment le gérer.
Ajouter du contexte
Ouvrez la section Contexte du projet et ajoutez une entrée. Chacune possède un titre et un corps, et peut être modifiée ou supprimée ultérieurement.
De bonnes entrées sont courtes, spécifiques et pérennes. Les décisions d'architecture, conventions de style, contrats API, limites de propriété et interdictions explicites y trouvent leur place. Le récit d'intégration et tout ce qui est déjà évident dans le 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 retrouvables ; une seule entrée appelée « Notes » contenant les deux ne l'est pas.
Cela importe car le contexte est chargé sélectivement en fonction du travail en cours — voir Compétences progressives. Des entrées bien séparées permettent de charger la bonne lors de la bonne tâche.
Références
En plus des entrées écrites, vous pouvez joindre des références — liens et documents qui pointent vers des éléments stockés ailleurs. Utilisez-les lorsque la version officielle se trouve dans un wiki ou un outil de conception et que vous ne souhaitez pas créer une copie obsolète.
Contexte par tâche
Le contexte du projet s'applique à tout ce qu'il contient. Pour le matériel pertinent à une tâche précise — un ticket, un rapport client, un document de conception — joignez-le à cette tâche plutôt qu'au contexte du projet. Une note spécifique à une tâche placée dans le contexte du projet devient un bruit parasite pour toutes les tâches futures.
Le maintenir à jour
Un contexte obsolète est pire qu'un contexte manquant, car les agents le considèrent comme fiable. Lorsqu'une convention évolue, mettez à jour l'entrée dans le même changement que le code.
Examiner ce qui existe
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 deviennent aujourd'hui trompeuses.