Le contexte est la seule réalité du modèle

Un agent n’a ni mémoire de votre projet, ni accès à vos intentions. Il n’a qu’une chose : la fenêtre de contexte.

Tout ce qui n’y figure pas n’existe pas. Et tout ce qui y figure a un coût. Apprendre à remplir cette fenêtre, c’est la compétence fondatrice du développement assisté.

Ce que voit réellement le modèle

À chaque tour de conversation, le modèle reçoit un unique document : instructions système, historique des échanges, fichiers ouverts, résultats d’outils. Il ne « se souvient » de rien. Ce document est reconstruit intégralement à chaque appel, puis jeté.

Conséquence directe : quand l’agent semble « oublier » une consigne, ce n’est pas un caprice. La consigne est sortie de la fenêtre, ou elle est noyée sous des informations plus saillantes. Le débogage commence toujours par la même question : qu’y avait-il, exactement, dans le contexte ?

La fenêtre n’est pas une mémoire

L’analogie avec la mémoire humaine est commode, et fausse sur trois points :

Une mémoire se consulte à la demande ; la fenêtre se subit en bloc, à chaque appel.
Plus la fenêtre grossit, plus l’attention se dilue : le milieu du document est la zone la moins lue.
Rien ne distingue, pour le modèle, une consigne importante d’un détail périmé. Tout est du texte au même rang.

Anatomie d’un contexte efficace

Le bon contexte est court, normatif et vérifiable. Il dit ce qui est vrai du projet, pas ce qui serait souhaitable en général. Exemple de CLAUDE.md qui travaille pour vous :

# CLAUDE.md

## Architecture
- Monorepo pnpm : `apps/web` (Astro), `packages/core` (domaine pur)

## Conventions
- Tests d'abord : aucun module sans test d'intégration
- Pas de commentaire qui paraphrase le code

## Commandes
- `pnpm test`   — suite complète
- `pnpm check`  — typage + lint

Le tips Craftomancer

Chaque phrase vague de votre CLAUDE.md sera interprétée des centaines de fois, dans des situations que vous n’avez pas prévues. L’ambiguïté n’est pas un défaut d’élégance : c’est de la dette qui s’exécute.

En pratique

Relisez votre CLAUDE.md comme un contrat : chaque ligne est-elle vraie et actionnable ?
Préférez dix lignes exactes à cent lignes plausibles.
Quand l’agent dévie, cherchez la cause dans la fenêtre avant de blâmer le modèle.
Mesurez : un contexte qui grossit est un contexte qui se dilue.

Vérifiez votre modèle

Quatre questions pour voir si ça tient. Cliquez une réponse : le verdict s’affiche.

Auto-évaluation 0 / 4

01 À chaque tour de conversation, le modèle reçoit…

02 L’agent « oublie » une consigne posée plus tôt. Premier réflexe ?

03 Pourquoi l’analogie « la fenêtre est une mémoire » est-elle trompeuse ?

04 Un bon `CLAUDE.md`, c’est avant tout…