Mes documents de projet ne sont plus destinés aux humains. Ils sont destinés à un agent qui les relit à chaque session.

DEV - 15/07
J'écrivais des documents/comme on me l'a appris : des paragraphes en prose, un peu de contexte, un "pourquoi on a fait ça"...

j'avais l'habitude d'écriredocuments/la façon dont on m'a appris : des paragraphes en prose, un peu de contexte, un récit « pourquoi nous avons fait ça » que vous remettriez à une nouvelle recrue. Puis j'ai remarqué quelque chose. Le seul lecteur ouvrant ces fichiers chaque jour n’était pas un humain. Il s'agissait d'un agent qui les chargeait à nouveau au début de chaque session, avec un budget symbolique et zéro mémoire de la veille.

Cela change ce que signifie « bonne documentation », et je n'ai pas réellement mis à jour mon style d'écriture jusqu'à ce qu'une ligne obsolète dans l'un de ces fichiers provoque un véritable bug.

La configuration

Dans monmon-git-managerdépôt,CLAUDE.mdpointe un agent versdocs/project_notes/à chaque démarrage de session :

## Project Memory System Les connaissances institutionnelles vivent dans `docs/project_notes/`. Vérifiez avant de proposer des modifications. - **bugs.md** — bugs connus et solutions - **decisions.md** — pourquoi les choses ont été construites telles qu'elles étaient (ADR) - **key_facts.md** — noms d'utilisateur, points de terminaison d'API, objectifs des fichiers, commandes d'exécution - **issues.md** — journal de travail **P...
[Courte citation de 8% de l'article original]