Files
Ustagammon/docs/lecons/README.md
T
Pierre MARTINandClaude Opus 5.5 635612a2a8 Cinq premières leçons dans docs/lecons/ (1g)
Les ouvertures, construire ses cases, frapper ou non, la course et le
compte de points, sortir sans se faire frapper : seize exercices au
format du tutoriel, avec le compte de points en plus. Amendement de
l'ADR 0011 : pas de relecture préalable, garde-fous du moteur.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 10:18:07 +01:00

2.1 KiB

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 test le 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.