Décisions en ADR ; plans et feuille de route temporaires

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

CLAUDE.md

@@ -4,7 +4,7 @@ Ce fichier est lu par Claude Code au début de chaque session. Il fixe le cadre
 Le cadrage complet est dans `docs/cadrage.md`, l'étape en cours dans `docs/etape-0.md`.
 
 **En début de session**, lire `docs/organisation.md`, `docs/feuille-de-route.md`, la fin
-de `docs/journal.md` et les plans en cours dans `docs/plans/`, puis reprendre là où en
+de `docs/journal.md`, l'index des ADR (`docs/adr/README.md`) et les plans en cours dans `docs/plans/`, puis reprendre là où en
 est la feuille de route.
 
 ## Le projet en bref
@@ -46,14 +46,14 @@ Des cibles plus fines (`make engine`, `make engine-wasm`, `make bench`…) sont
 
 ## Façon de travailler
 
-0. **Pilotage.** La session principale est chef de projet technique : elle tient la feuille de route et délègue l'exécution à des sous-agents, selon `docs/organisation.md`. Toute tâche déléguée a son plan dans `docs/plans/`, écrit avant la délégation et complété à la clôture. Rien d'important ne vit seulement dans la mémoire d'une session.
+0. **Pilotage.** La session principale est chef de projet technique : elle tient la feuille de route et délègue l'exécution à des sous-agents, selon `docs/organisation.md`. Toute tâche déléguée a son plan dans `docs/plans/`, écrit avant la délégation et supprimé à la clôture. Chaque décision structurante a son ADR dans `docs/adr/`. Rien d'important ne vit seulement dans la mémoire d'une session.
 1. **Petites étapes vérifiables.** Une étape = un résultat observable (une commande qui répond, un test qui passe). Présenter un plan court avant toute étape de plus d'une heure.
 2. **Tests d'abord pour le moteur.** Les positions de référence sont évaluées avec le GNU Backgammon de bureau (en ligne de commande, dans Docker) et stockées dans `tests/reference/`. Le moteur embarqué doit concorder.
 3. **Expliquer simplement.** Après chaque étape : ce qui a été fait, comment le vérifier soi-même (commande exacte), ce qui reste.
 4. **Ne jamais masquer un échec.** Pas de test désactivé, pas de résultat simulé. Dire clairement ce qui bloque et la cause probable.
 5. **Commits fréquents**, messages courts en français, sur une branche dédiée. Jamais de commit direct sur `main` : chaque changement passe par une merge request Gitea (`tea pulls create --login sans-pub`), décrite selon `docs/organisation.md`. Claude Code la fusionne lui-même une fois `make lint` et `make test` au vert.
 6. **Dépendances** : peu, maintenues, compatibles GPLv3. Signaler chaque nouvelle dépendance et sa licence.
-7. **Journal** : `docs/journal.md` reçoit une entrée datée à la fin de chaque session (fait, décidé, reste à faire). Les décisions structurantes vont dans `docs/decisions.md`.
+7. **Journal** : `docs/journal.md` reçoit une entrée datée à la fin de chaque session (fait, décidé, reste à faire). Les décisions structurantes vont dans un ADR (`docs/adr/`), jamais réécrit une fois accepté.
 
 ## Sources du moteur
 
@@ -72,7 +72,7 @@ Respecter les mentions de copyright ; créditer ces projets dans `CREDITS.md`.
 ├── LICENSE              GPLv3
 ├── CREDITS.md
 ├── docs/                cadrage, feuille de route, organisation, étape en cours,
-│                        plans des tâches déléguées, journal, décisions
+│                        plans des tâches déléguées, ADR, journal
 ├── engine/              sources du moteur (sous-module ou copie versionnée) + interface C
 ├── engine-cli/          programme en ligne de commande pour interroger le moteur
 ├── web/                 prototype puis application PWA