Ustagammon/docs/plans/2026-11-03-conseil-du-maitre.md

Conseil du maître (1d)

• Date : 2026-11-03
• Étape : 1d (docs/etape-1.md)
• Statut : prévu (après 1c)
• Exécutant : sous-agent general-purpose, dans un worktree

Objectif

Le coach bienveillant, « mis en avant mais discret » (Pierre, 2026-11-03) : après chaque coup et chaque décision de videau du joueur, jamais avant (ADR 0011), une appréciation et une phrase du maître fondées sur les chiffres du moteur.

Références

• ADR 0011 ; maquette « conseil du maître après le coup » du canevas https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe ; règles de la charte (docs/identite/charte/, dont interaction.md) ; la ligne réservée de 44 px de la révision UX.
• Moteur : analyseMove, analyseCube, luck, seuils SKILL_THRESHOLDS (gnubg : 0,03 / 0,06 / 0,12).

Consignes

1. Analyse en arrière-plan : après la validation d'un coup (ou une décision de videau), l'analyse à 2 plis part dans le Worker sans retarder le tour de l'ordinateur ; son résultat est rattaché au coup dans le journal (événement d'analyse rétrocompatible, ou cache séparé justifié) pour servir au bilan (1e) sans recalcul.
2. Ligne du maître : icône d'appréciation, mot en couleur (« Bon coup. », « Imprécision. », « Erreur. », « Gaffe. » : correspondance avec les seuils de gnubg documentée), phrase courte en italique, chevron. Toucher ouvre la feuille d'explication : coup joué et meilleur coup montrés sur le plateau (pions animés, ADR 0011 « comparaison visuelle »), écart d'équité seulement sur demande, lien vers la fiche du glossaire du concept en jeu si le moteur permet de le déterminer, sinon rien.
3. Phrases du maître : gabarits versionnés en français dans une source unique sous docs/ (CC BY-SA 4.0), ton encourageant, jamais culpabilisant ; elles ne citent que des faits du moteur (coup recommandé, rang, pions frappés, écart) : aucune explication inventée. Première version à faire valider par Pierre (ton).
4. Discret : rien n'apparaît pendant que le joueur réfléchit ; la ligne s'efface à l'action suivante ; désactivable (réglage de 1c et menu).
5. Videau : même traitement pour doubler, ne pas doubler, prendre, passer.
6. Scénarios Gherkin (bon coup, erreur avec meilleur coup montré, conseil désactivé, décision de videau commentée) avec positions et dés imposés ; tests unitaires des gabarits (chaque gabarit rendu sur des analyses réelles du moteur). make lint, make test, make test-browser, captures pour la recette design.

Critères de réussite

Après une erreur volontaire dans une position connue, la ligne du maître dit « Erreur. », nomme le coup recommandé par le moteur et le montre sur demande ; le tour de l'ordinateur n'est pas retardé ; les trois commandes passent.

Résultat

À remplir à la clôture.