Leçons
Les cinq premières leçons d'Ustagammon (ADR 0011, étape 1g), une leçon par
fichier, en une seule source (ADR 0008) : lecon-1.md à lecon-5.md.
make site copie ce dossier dans le site publié (docs/lecons/) ;
l'application le lit à l'exécution (app/src/ui/lesson-text.ts), et
make test vérifie chaque position, chaque coup et chaque compte de points
avec le vrai moteur (app/tests/lessons.test.ts).
Textes sous licence CC BY-SA 4.0. Première version, rédigée par Claude Code ; décision de Pierre du 2026-11-09 : pas de relecture préalable par un joueur fort, les leçons sont livrées telles quelles et améliorées sur retours d'experts.
Garde-fous
- Chaque coup attendu d'un exercice « à vous » est le meilleur coup du
moteur à 2 plis, avec plus de 0,04 d'équité d'avance sur le deuxième :
un exercice n'a qu'une bonne réponse nette.
make testle vérifie. - Chaque coup illustré d'un écran d'explication est aussi le meilleur coup du moteur à 2 plis.
- Le texte n'affirme rien que le moteur ne confirme : les coups du maître,
les points faits, les pions frappés ou laissés seuls (lisibles dans la
position), les comptes de points (
compte, vérifiés par le test). Aucune explication stratégique inventée. - Le vocabulaire est celui du glossaire (
docs/glossaire/) : flèche, point, jan intérieur, jan extérieur, blot, barre ; vos pions sont blancs, ceux de l'ordinateur noirs. - Le ton est celui du maître (
docs/maitre/phrases.md) : première personne, vouvoiement, sobre, sans point d'exclamation ni reproche.
Format
Celui du tutoriel (docs/tutoriel/README.md), avec deux ajouts :
- la première ligne,
# <titre>, donne le titre de la leçon ; la notice qui suit, jusqu'à la première étape, n'est pas affichée ; compte: <vous>/<ordinateur>, en tête d'un écran, donne les comptes de points de sa position, que le texte cite ; le test les compare à ceux du moteur.
Chaque leçon a de deux à quatre exercices « à vous » (### À vous), et un
écran de fin (## Fin) dont l'action mène à la leçon suivante, ou à la
liste des leçons après la dernière.