# 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.