Charte : règles d'interaction, ADR 0012 précisé #23

2026-11-03T06:12:50Z

pierre commented

2026-11-03 06:12:50 +00:00

Pourquoi

Après son premier essai sur le téléphone, Pierre a trouvé l'écran de jeu peu immersif. Il a demandé que la session design et la session de développement s'accordent sur l'expérience. Le designer UI de la session de développement a rendu une revue (étape 0e.2) : compte de points, fluidité, paysage, vibrations. La session design l'a arbitrée, sur délégation de Pierre (« je te fais confiance »), et a complété les maquettes.

Il restait deux manques. D'abord, les règles de comportement qui en découlent n'existaient nulle part dans le dépôt. Ensuite, le premier amendement de l'ADR 0012 décrivait un placement des contrôles que la revue a montré fautif : des pictogrammes posés sur une cible de jeu, et le videau posé là où s'empilent les pions frappés.

Quoi

docs/identite/charte/interaction.md fixe les règles de comportement de l'app :
- les principes : réponse immédiate, rien ne bouge sous le doigt, annuler plutôt que confirmer, une seule action principale, le joueur garde la main, le maître parle après le coup ;
- les jetons de mouvement ;
- les vibrations ;
- les raccourcis clavier sur ordinateur ;
- les pictogrammes ;
- les trois mises en page de l'écran de jeu.
tokens.json reçoit les familles duration (90, 160 et 240 ms) et easing.
Le guide de marque renvoie vers la nouvelle section.
L'ADR 0012 reçoit un second amendement daté sur le placement des contrôles en paysage :
- une colonne de commandes à gauche (menu, videau, annuler ou revoir) ;
- les sorties restent libres ;
- les comptes de points sont des pastilles sur la barre.

Le code ne change pas. Les maquettes de référence sont sur https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe (rangées « Révision UX »).

Comment

L'arbitrage reprend presque toutes les propositions de la revue. Les écarts et les précisions sont les suivants.

Passage automatique du tour : refusé. Pierre a demandé explicitement de ne jamais passer sans action. Les dés se barrent, et le joueur passe en les touchant, le même geste que pour valider un coup.
« Nouvelle partie » : sans confirmation. L'action est immédiate, puis un bandeau « Reprendre l'ancienne » reste 10 s. Le journal d'événements permet ce retour en arrière.
L'écart au compte de points s'écrit « mène de 8 » et non « −8 », que les débutants lisent mal.
Le conseil du maître (ADR 0011) occupe une ligne fixe sous le bandeau du joueur, uniquement après le coup.

Choix et compromis

Le premier amendement de l'ADR 0012 n'est pas réécrit, comme le veut la règle des ADR. Le second le précise.
Les raccourcis clavier sont de priorité basse : à prévoir dans l'architecture des actions, mais à livrer après le paysage.
Les motifs de vibration restent à régler à la main sur le Fairphone 4.

Risques et déploiement

Aucun : il n'y a que de la documentation. Pour revenir en arrière, il suffit d'annuler le commit de fusion.

Comment vérifier

make lint
make test
python3 -c "import json; json.load(open('docs/identite/charte/tokens.json'))"

Hors périmètre

L'implémentation (étapes 0e.3 et suivantes), faite par la session de développement.

Generated with Claude Code (https://claude.com/claude-code)

## Pourquoi Après son premier essai sur le téléphone, Pierre a trouvé l'écran de jeu peu immersif. Il a demandé que la session design et la session de développement s'accordent sur l'expérience. Le designer UI de la session de développement a rendu une revue (étape 0e.2) : compte de points, fluidité, paysage, vibrations. La session design l'a arbitrée, sur délégation de Pierre (« je te fais confiance »), et a complété les maquettes. Il restait deux manques. D'abord, les règles de comportement qui en découlent n'existaient nulle part dans le dépôt. Ensuite, le premier amendement de l'ADR 0012 décrivait un placement des contrôles que la revue a montré fautif : des pictogrammes posés sur une cible de jeu, et le videau posé là où s'empilent les pions frappés. ## Quoi - `docs/identite/charte/interaction.md` fixe les règles de comportement de l'app : - les principes : réponse immédiate, rien ne bouge sous le doigt, annuler plutôt que confirmer, une seule action principale, le joueur garde la main, le maître parle après le coup ; - les jetons de mouvement ; - les vibrations ; - les raccourcis clavier sur ordinateur ; - les pictogrammes ; - les trois mises en page de l'écran de jeu. - `tokens.json` reçoit les familles `duration` (90, 160 et 240 ms) et `easing`. - Le guide de marque renvoie vers la nouvelle section. - L'ADR 0012 reçoit un second amendement daté sur le placement des contrôles en paysage : - une colonne de commandes à gauche (menu, videau, annuler ou revoir) ; - les sorties restent libres ; - les comptes de points sont des pastilles sur la barre. Le code ne change pas. Les maquettes de référence sont sur https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe (rangées « Révision UX »). ## Comment L'arbitrage reprend presque toutes les propositions de la revue. Les écarts et les précisions sont les suivants. - **Passage automatique du tour : refusé.** Pierre a demandé explicitement de ne jamais passer sans action. Les dés se barrent, et le joueur passe en les touchant, le même geste que pour valider un coup. - **« Nouvelle partie » : sans confirmation.** L'action est immédiate, puis un bandeau « Reprendre l'ancienne » reste 10 s. Le journal d'événements permet ce retour en arrière. - **L'écart au compte de points** s'écrit « mène de 8 » et non « −8 », que les débutants lisent mal. - **Le conseil du maître** (ADR 0011) occupe une ligne fixe sous le bandeau du joueur, uniquement après le coup. ## Choix et compromis - Le premier amendement de l'ADR 0012 n'est pas réécrit, comme le veut la règle des ADR. Le second le précise. - Les raccourcis clavier sont de priorité basse : à prévoir dans l'architecture des actions, mais à livrer après le paysage. - Les motifs de vibration restent à régler à la main sur le Fairphone 4. ## Risques et déploiement Aucun : il n'y a que de la documentation. Pour revenir en arrière, il suffit d'annuler le commit de fusion. ## Comment vérifier make lint make test python3 -c "import json; json.load(open('docs/identite/charte/tokens.json'))" ## Hors périmètre L'implémentation (étapes 0e.3 et suivantes), faite par la session de développement. Generated with Claude Code (https://claude.com/claude-code)

pierre added 1 commit 2026-11-03 06:12:51 +00:00

Charte : règles d'interaction, jetons de mouvement, ADR 0012 précisé 4403fc2844

interaction.md : réponse immédiate, annuler plutôt que confirmer,
mouvement (durées et courbes), vibrations, clavier sur ordinateur,
mises en page de l'écran de jeu, pictogrammes. ADR 0012 : placement des
contrôles en paysage après la revue UX (colonne de commandes à gauche,
sorties libres, comptes en pastilles sur la barre).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

pierre merged commit 5d0cf45539 into main

2026-11-03 06:12:52 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: pierre/Ustagammon#23