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