Files
Ustagammon/docs/lecons
Pierre MARTINandClaude Opus 5.5 351482fa9e Recette 1g : textes corrigés, boutons en bas, barre haute en paysage
Leçon 1 §2 (flèche 7 vide, 5 déjà bloqué), leçon 2 « Faire des points »,
flèches 7 à 12, reformulations des leçons 3 et 4. Écran des leçons et du
tutoriel : « Retour » et « Continuer » en bas en portrait, « Revoir » sur
la ligne du titre, ligne « Leçon n · … » gardée en paysage. Barre haute
visible hors de l'écran de jeu en paysage (défaut antérieur à 1g), avec
un contrôle dans la recette automatique. Rappel des règles haut de
44 px ; « Aucune leçon terminée sur 5 · … » sur l'accueil.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 13:55:17 +01:00
..

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.