Ustagammon/docs/plans/2026-11-11-retours-joueurs.md

Retours des premiers joueurs

• Date : 2026-11-11
• Étape : 1 (retours des premiers joueurs, après 1f)
• Statut : en cours
• Exécutant : sous-agent general-purpose

Objectif

Mettre en œuvre dans l'application les règles tirées des retours des premiers joueurs par la session design (MR !54 et !55) : pions blancs et noirs avec contour, pions de l'ordinateur lisibles sur la barre, numéros des flèches sur le cadre en portrait, flèches circulaires au tutoriel, vocabulaire des jans.

Consignes

1. Pions blancs et noirs, avec contour (ADR 0010, amendement du 2026-11-11) : reporter dans web/app.css, pour les deux thèmes, les valeurs de docs/identite/charte/tokens.json pour checker-*, checker-*-edge, count-*, die-*, pip-*, cube et cube-text. Le logo et le cadre ne changent pas. Aucune couleur en dur dans le TypeScript.
2. Pions de l'ordinateur lisibles sur la barre : contour noir sur la barre à environ 6,8:1 (clair) et 8,5:1 (sombre). tests/browser/recette.mjs contrôle le contraste du contour des pions sur le fond qui les porte (3:1 au moins, règle de recette-ux.md).
3. Numéros des flèches sur le cadre en portrait : bandes haute et basse du cadre agrandies pour loger des numéros de 12 px au moins ; geometry.ts, ses tests et la recette adaptés.
4. Tutoriel, étape 2 : deux flèches circulaires (claire pour le joueur, sombre pour l'ordinateur, chacune dans le sens de son joueur, avec une pointe), dessinées sous les pions, avec un liseré de la couleur opposée ; jamais en brique.
5. Les jans : « jan intérieur » (flèches 1 à 6) et « jan extérieur » (7 à 12) remplacent « camp » dans le tutoriel, l'aide, les phrases du maître et les prompts ; fiches jan-interieur.md (Home board) et jan-exterieur.md (Outer board) reliées au code ; fiche « camp » retirée sans lien cassé ; dans regles.md, pions « blancs » et « noirs ».

Limites : CSP stricte (aucun .style.), aucune nouvelle dépendance, -j2 au plus, pas de recompilation du moteur. Vérifier avec docker ps qu'aucun autre test navigateur ne tourne avant make test-browser.

Critères de réussite

• make lint, make test et make test-browser passent.
• Captures dans build/browser-shots/retours-joueurs/ (412×915 et 915×412, thèmes clair et sombre) : pions des deux camps sur la barre, étape 2 du tutoriel, portrait avec les numéros sur le cadre.
• Aucune occurrence de « camp » au sens de jan dans docs/tutoriel/, docs/scenarios/, docs/maitre/ et docs/prompts/.

Résultat

Rempli à la clôture.