Créer des Contextes

Guide étape par étape pour créer des Documents de contexte dans CodeCourier, rédiger du contenu markdown efficace, publier votre première version et lier les Contextes aux personas et session types.

8 min lire
contextscreatemarkdown

Ce guide vous accompagne dans la création d’un Document de contexte de A à Z - de la navigation vers la page des Contextes, à la rédaction d’un contenu markdown bien structuré, à la publication de votre première version, et enfin à la liaison du Contexte aux session types ou personas qui doivent le recevoir.

Naviguer vers la page des Contextes

Les Contextes sont accessibles depuis la sidebar du projet. Recherchez l’entrée Contextesdans le panneau de navigation gauche. Si vous ne la voyez pas, assurez-vous d’avoir au moins un accès Membre au projet. La page des Contextes se trouve à /p/{projectId}/context.

La page liste tous les Contextes existants du projet, affichant pour chacun son nom, sa description, le nombre de versions publiées, et la date de publication de la version active. Si aucun Contexte n’a encore été créé, vous verrez un état vide avec un bouton Créer un Contexte bien visible.

Créer un nouveau Contexte

1

Ouvrir la boîte de dialogue de création

Cliquez sur + Créer un Contextedans le coin supérieur droit de la page des Contextes. Une boîte de dialogue s’ouvre demandant les métadonnées de base du Contexte.

2

Saisir un nom (requis)

Donnez au Contexte un nom descriptif qui reflète son sujet. Les bons noms communiquent l’intention en un coup d’œil :

  • Architecture du projet - vue d’ensemble de la stack complète et conventions
  • Standards de code - règles de style, configuration TypeScript, linting
  • Checklist de sécurité - exigences OWASP, règles de sanitization des entrées
  • Référence API - endpoints clés, patterns d’authentification, limites de débit
  • Conventions de test - configuration Vitest, patterns de mock, objectifs de couverture

Les noms ne doivent pas être vides et sont validés à la soumission. Vous pouvez renommer le Contexte plus tard depuis sa page de détail.

3

Ajouter une description (optionnel mais recommandé)

La description apparaît sur la page de liste des Contextes et dans les menus déroulants de liaison tout au long des paramètres du projet. Une description claire aide les membres de l’équipe à comprendre quel Contexte lier à un session type sans avoir à ouvrir et lire l’intégralité du contenu. Par exemple :

“Vue d’ensemble architecturale complète de la stack Next.js + Convex + Clerk, incluant les conventions de fichiers et le flux de données. À injecter dans toutes les sessions Designer.”

4

Soumettre le formulaire

Cliquez sur Créer. Vous êtes redirigé vers la page de détail du Contexte où vous pouvez rédiger le contenu markdown complet et publier votre première version.

Rédiger le contenu du Contexte

La page de détail du Contexte contient un éditeur markdown complet. Le contenu que vous rédigez ici est exactement ce qui est injecté dans les sessions sandbox. Rédigez-le de la même manière que vous écririez un fichier CLAUDE.md - clairement structuré, avec des titres pour la navigation et des puces pour des règles faciles à parcourir.

Que faut-il inclure

Un contenu de Contexte efficace est spécifique et actionnable. Les agents performent mieux quand ils disposent de règles concrètes et non ambiguës plutôt que de directives vagues. Structurez votre contenu avec :

  • Une section vue d’ensemble décrivant la stack technologique à un niveau élevé
  • Des sections de conventions de fichiers listant où vivent les différents types de fichiers
  • Des standards de code couvrant les conventions de nommage, les patterns et les anti-patterns à éviter
  • Des contraintes clés utilisant un langage explicite “jamais” et “toujours”
  • Des dépendances importantes ou de la configuration dont les agents doivent avoir connaissance

Exemple de contenu de Contexte

Voici un exemple de Contexte Architecture du projet bien rédigé pour une application TypeScript full-stack :

project-architecture-context.md
# Project Architecture

This is a Next.js 16 application with:
- **Frontend**: React 19, TypeScript, Tailwind CSS, shadcn/ui
- **Backend**: Convex (reactive database + server functions)
- **Auth**: Clerk

## Coding Standards
- Always use TypeScript strict mode
- Prefer server components over client components
- Use Convex mutations for all data writes
- Never use `dangerouslySetInnerHTML` without sanitization

## File Conventions
- Components: PascalCase in `/components/`
- Hooks: camelCase with `use` prefix in `/hooks/`
- Utils: camelCase in `/lib/`

## Convex Rules
- Never use `.collect()` on large tables - use `.take(N)` or paginate
- Batch work goes to `ctx.scheduler.runAfter` to avoid timeout
- Mutations validate input with Convex validators, not Zod

## Next.js Specifics
- The middleware file is `proxy.ts`, NOT `middleware.ts`
- All API routes live in `/app/api/`
- Use `generateStaticParams` for static paths, not `getStaticPaths`

## Testing
- Unit tests: Vitest with `@testing-library/react`
- E2E tests: Playwright in `/e2e/`
- Run `bun test` before every commit

Gardez le contenu ciblé

Résistez à la tentation de déverser tout votre wiki de codebase dans un seul Contexte. Les agents ont des fenêtres de contexte limitées. Rédigez des informations ciblées et pertinentes et créez des Contextes séparés pour des domaines distincts (architecture, sécurité, tests) plutôt qu’un unique document énorme.

Publier votre première version

1

Rédiger ou coller votre contenu

Saisissez le contenu markdown dans l’éditeur sur la page de détail du Contexte. L’éditeur prend en charge un aperçu en direct pour voir comment le contenu sera rendu.

2

Cliquer sur Publier

Cliquez sur le bouton Publier pour créer la version 1 de ce Contexte. Lors de la publication, CodeCourier crée un nouvel enregistrement de version avec le statut activeet enregistre l’horodatage actuel ainsi que votre identité d’utilisateur en tant que publieur.

3

Vérifier la version active

Après la publication, la page affiche le numéro de version et la date de publication dans le panneau d’historique des versions. Le badge sur la version active indique Active. C’est cette version qui sera injectée dans les sandboxes.

Modifications non publiées

Si vous modifiez le contenu sans cliquer sur Publier, vos changements sont enregistrés comme brouillon. La version active dans les sandboxes reste la version précédemment publiée jusqu’à ce que vous publiiez à nouveau. L’éditeur affiche un indicateur “Modifications non publiées” lorsque votre brouillon diffère de la version active.

Consulter l’historique des versions

Le panneau Historique des versions sur la page de détail du Contexte liste chaque version publiée en ordre chronologique inversé. Chaque entrée affiche :

  • Le numéro de version (v1, v2, v3, …)
  • L’horodatage de publication
  • Qui l’a publiée (nom d’affichage de l’utilisateur)
  • Le badge de statut actif ou inactif

Cliquez sur une version pour voir son contenu en mode lecture seule. Cela vous permet de comparer la version active actuelle avec des versions historiques pour comprendre ce qui a changé.

Lier un Contexte à une persona

Pour lier un Contexte à une persona spécifique, naviguez vers la page de détail de la persona à /p/{projectId}/personas/{personaId} et ouvrez l’onglet Contexte. De là, utilisez le menu déroulant pour sélectionner le Contexte que vous voulez que cette persona utilise. Une fois enregistré, chaque session exécutée par cette persona injectera le Contexte lié de la persona au lieu de la valeur par défaut du session type.

L'override de persona a priorité

Définir un Contexte sur une persona écrase la valeur par défaut du session type. Si vous voulez qu’une persona n’utilise aucun Contexte (même quand le session type en a un par défaut), vous devez explicitement effacer la liaison de Contexte de la persona plutôt que de la laisser non définie - une liaison de persona non définie retombe sur la valeur par défaut du session type.

Lier un Contexte à un session type

Les liaisons de session type sont gérées depuis les Paramètres du projet. Chaque session type a son propre onglet de configuration :

  • Configuration Answering - /p/{id}/answering-setup
  • Configuration Issues - /p/{id}/issues-setup
  • Configuration Learning - /p/{id}/learning-setup
  • Configuration Merging - /p/{id}/merging-setup
  • Configuration Evaluator - /p/{id}/evaluator-setup
  • Configuration Judge - /p/{id}/judge-setup

Sur chaque onglet de configuration, trouvez le champ Contexte et sélectionnez le Contexte que vous voulez que toutes les sessions de ce type reçoivent par défaut. La liaison est enregistrée immédiatement à la sélection.

Étapes suivantes

Gérer les Contextes

Découvrez comment modifier, versionner, restaurer et supprimer les Contextes.

Paramètres du projet

Configurez les liaisons de Contexte des session types et les autres paramètres du projet.