Correction du README, organisation par sous-agents et feuille de route

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Pierre MARTIN
2026-11-02 12:58:16 +01:00
co-authored by Claude Opus 5.5
parent 7fd23031ca
commit 7e58707bc3
9 changed files with 212 additions and 119 deletions
+7 -1
View File
@@ -3,6 +3,10 @@
Ce fichier est lu par Claude Code au début de chaque session. Il fixe le cadre du projet.
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
est la feuille de route.
## Le projet en bref
**Ustagammon** : application de backgammon pour apprendre et progresser, entièrement hors ligne.
@@ -42,6 +46,7 @@ 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.
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.
@@ -66,7 +71,8 @@ Respecter les mentions de copyright ; créditer ces projets dans `CREDITS.md`.
├── Makefile
├── LICENSE GPLv3
├── CREDITS.md
├── docs/ cadrage, étape en cours, journal, décisions
├── docs/ cadrage, feuille de route, organisation, étape en cours,
│ plans des tâches déléguées, journal, décisions
├── 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