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>
This commit is contained in:
Pierre MARTIN
2026-11-12 10:18:07 +01:00
co-authored by Claude Opus 5.5
parent cfb2e485c3
commit 635612a2a8
10 changed files with 481 additions and 36 deletions
+44
View File
@@ -0,0 +1,44 @@
# 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.