« Demander à une IA » : bouton, feuille du prompt à son adresse, copie

Le bouton, secondaire, dans la feuille du maître, sur le bilan, dans
l'analyse et sur la fiche ouverte du glossaire. Il ouvre la feuille du
prompt (…/ia, amendement de l'ADR 0013), où le texte se relit avant la
copie : navigator.clipboard, repli par sélection du texte, bandeau
« Prompt copié » (2 s). Gabarits copiés par make site (amendement de
l'ADR 0008), scénario « Demander à une IA », 1f marquée faite.

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

docs/adr/0008-glossaire-et-scenarios-source-unique.md

@@ -108,3 +108,13 @@ avec Gherkin et l'exécution de bout en bout par l'interface.
 - **Perspective** : si les scénarios peuvent un jour être joués dans une
   instance réelle de l'application, la même exécution produira les captures
   d'écran de l'aide, toujours à jour avec la version installée.
+
+### 2026-11-10 — Les prompts pour une IA, même principe
+
+Avec « Demander à une IA » (étape 1f), les gabarits des prompts suivent la
+même règle que le glossaire, les scénarios, le tutoriel et les phrases du
+maître : une seule source, `docs/prompts/` (un fichier par gabarit, sous
+CC BY-SA 4.0), copiée dans le site par `make site` et lue par l'application
+à l'exécution ; jamais recopiée dans le code. `make test` remplit chaque
+gabarit avec de vraies analyses du moteur (`app/tests/prompts.test.ts`) et
+le scénario `docs/scenarios/demander-a-une-ia.feature` en fait l'aide.

docs/adr/0013-position-dans-l-adresse.md

@@ -159,3 +159,33 @@ non, lancer, jouer), à partir de 1, sur sa ligne courante.
 - Comme la feuille d'explication, ces adresses n'ont de sens que sur
   l'appareil qui a joué la partie. Une partie absente donne un message,
   jamais une page cassée.
+
+### 2026-11-10 — Adresses de la feuille du prompt pour une IA
+
+Ajoutées avec « Demander à une IA » (étape 1f), dans le même schéma. La
+feuille montre le prompt pour qu'on le relise avant de le copier : c'est un
+écran à part entière, elle a donc son adresse, celle de l'écran d'où on la
+demande suivie de `/ia` :
+
+| Écran | Adresse |
+| --- | --- |
+| Prompt d'une décision, depuis la feuille d'explication du maître | `#/explication/<événement>/ia` |
+| Prompt du bilan d'une partie | `#/parties/<id>/bilan/ia` |
+| Prompt de la décision d'un coup, depuis l'analyse | `#/parties/<id>/analyse/<coup>/ia` (ou `…/analyse/ia`, sur le coup à revoir) |
+| Prompt d'un terme du glossaire | `#/glossaire/<fiche sans .md>/ia` |
+
+- La feuille monte au-dessus de l'écran d'en dessous, qui reste dessiné
+  (la feuille du maître, le bilan, l'analyse ou le glossaire). « Fermer »,
+  la croix, Échap et le retour du téléphone reviennent à cet écran ; ouverte
+  par son adresse, sans historique, la fermer remplace l'adresse par celle
+  de l'écran d'en dessous.
+- Rechargée, l'adresse rouvre la même feuille : le prompt est recalculé à
+  partir du journal enregistré. Comme ses écrans, elle n'a de sens que sur
+  l'appareil qui a joué la partie (sauf pour le glossaire). Une décision
+  sans conseil, une partie absente ou pas encore analysée donne un message,
+  jamais une page cassée.
+- Le bandeau « Prompt copié » n'a pas d'adresse : c'est un bandeau
+  éphémère.
+- Le prompt contient, lui, le lien public de la position
+  (`https://ustagammon.sans.pub/#/position/<Position ID>/<Match ID>`),
+  qui se partage.

docs/etape-1.md

@@ -22,7 +22,7 @@ Repris du cadrage (modules, écrans clés, IA générative en V1) et des ADR 001
 | 1c. Match et réglages (fait) | Partie libre ou match en N points, règle Crawford, règle Jacoby, choix du niveau de l'ordinateur, conseil du maître activable ou non ; écran de nouvelle partie | 1a, 1b |
 | 1d. Conseil du maître (fait) | Après chaque coup du joueur, jamais avant (ADR 0011) : appréciation du moteur (bon coup, imprécision, erreur, grosse erreur) avec mot, icône et couleur, phrase du maître fondée sur les chiffres du moteur, coup recommandé montré sur demande ; aussi pour les décisions de videau ; calcul en arrière-plan sans retarder le jeu | 1a |
 | 1e. Fin de partie et analyse (fait) | Bilan (ADR 0011) : résultat, coups par appréciation, taux d'erreur comparé à la chance, « le coup à revoir » ; écran d'analyse : graphe d'équité (toucher un point ouvre la position), liste des erreurs filtrable, visualiseur pas à pas coup joué contre meilleur coup, « Rejouer d'ici » | 1a, 1b, 1d |
-| 1f. Prompts à copier | Gabarits versionnés et testés (`docs/prompts/` ou équivalent, source unique), bouton « Demander à une IA » sur le plateau, le conseil du maître, l'analyse et la fin de partie ; le moteur décide, l'IA explique | 1d, 1e |
+| 1f. Prompts à copier (fait) | Gabarits versionnés et testés (`docs/prompts/` ou équivalent, source unique), bouton « Demander à une IA » sur le plateau, le conseil du maître, l'analyse et la fin de partie ; le moteur décide, l'IA explique | 1d, 1e |
 | 1g. Accueil, tutoriel et leçons | Accueil (reprendre, nouvelle partie, prochaine leçon, progression résumée), tutoriel des règles interactif et illustré (0e.5), cinq premières leçons numérotées (ADR 0011) avec positions et « à vous de jouer », progression locale ; contenus CC BY-SA 4.0 en brouillon, à relire par un joueur fort | 0e.5, 1a |
 | 1h. Progression | Historique des parties et courbe du taux d'erreur | 1b, 1e |
 | 1i. Plateau soigné | Dessin du plateau aligné sur la charte (`docs/identite/charte/board.js`), animations des pions, glisser-déposer en plus du toucher, double toucher pour le seul coup évident | 0e.3 |

docs/scenarios/README.md

@@ -59,6 +59,7 @@ Règles d'écriture :
 | [jouer-un-match.feature](jouer-un-match.feature) | Choisir sa partie (libre ou match, niveau) et jouer un match | Étape 1c |
 | [comprendre-mes-coups.feature](comprendre-mes-coups.feature) | Comprendre ses coups avec le conseil du maître | Étape 1d |
 | [revoir-ma-partie.feature](revoir-ma-partie.feature) | Revoir sa partie : bilan, coup à revoir, analyse, rejouer d'ici | Étape 1e |
+| [demander-a-une-ia.feature](demander-a-une-ia.feature) | Demander à une IA d'expliquer un coup, une partie ou un mot | Étape 1f |
 | [mes-parties.feature](mes-parties.feature) | Retrouver mes parties, leurs branches, les exporter en SGF | Étape 1b |
 | [partager-une-position.feature](partager-une-position.feature) | Ouvrir et partager le lien d'une position | Étape 0e.4 |
 | [regler-l-application.feature](regler-l-application.feature) | Régler l'application (menu), la mettre à jour | Étape 0e |

docs/scenarios/demander-a-une-ia.feature

@@ -0,0 +1,45 @@
+# language: fr
+Fonctionnalité: Demander à une IA d'expliquer un coup, une partie ou un mot
+
+  Le maître dit quel coup il aurait joué ; pour comprendre pourquoi, vous
+  pouvez demander à une IA de votre choix. Touchez « Demander à une IA »
+  dans l'explication du maître, sur le bilan, dans l'analyse ou sur la fiche
+  d'un mot du jeu : l'application prépare une question complète, avec la
+  position, son lien et les chiffres de GNU Backgammon. Relisez-la, copiez-la,
+  puis collez-la dans l'IA. L'application n'appelle aucune IA et n'envoie
+  rien : le moteur décide, l'IA explique, et la question lui demande de ne
+  pas contredire les chiffres du moteur.
+
+  Scénario: Comment demander à une IA d'expliquer mon erreur ?
+    Touchez « Demander à une IA » dans l'explication du maître : la question
+    donne la position avant votre coup, dessinée en texte, ses identifiants
+    de GNU Backgammon et son lien, puis les trois meilleurs coups du maître et
+    le vôtre, avec les mêmes chiffres que l'explication du maître.
+
+    Étant donné que vous avez joué 24/23 13/10 avec un 3-1 d'ouverture
+    Quand vous demandez à une IA d'expliquer ce coup
+    Alors la question donne la position, avec son Position ID, son Match ID et son lien
+    Et elle donne les trois meilleurs coups du maître et le vôtre, avec les chiffres de l'explication
+    Et elle demande à l'IA de ne pas contredire ces chiffres, et de répondre en français
+
+  Scénario: Comment demander à une IA le bilan de ma partie ?
+    Sur le bilan, « Demander à une IA » prépare une question sur toute la
+    partie : le résultat, vos décisions par appréciation, votre niveau, la
+    chance des dés, vos erreurs et leur coût, et la position du coup à
+    revoir. L'IA vous propose trois thèmes à travailler.
+
+    Étant donné une partie finie où vous avez joué 6/5 5/off avec 6-1, puis passé le double de l'ordinateur
+    Quand vous demandez à une IA le bilan de votre partie
+    Alors la question donne vos décisions, votre niveau et la chance des dés, comme le bilan
+    Et elle cite votre coup 6/off, le coup du maître 6/off 1/off et leur écart
+    Et elle donne la position du coup à revoir
+
+  Scénario: Puis-je demander à une IA d'expliquer un mot du jeu ?
+    Oui : sur la fiche d'un mot du glossaire, la question reprend sa
+    définition et l'illustre par la position de votre partie en cours, ou par
+    la position de départ, avec l'évaluation de GNU Backgammon.
+
+    Étant donné qu'aucune partie n'est en cours
+    Quand vous demandez à une IA d'expliquer le mot « Videau »
+    Alors la question reprend la définition de sa fiche
+    Et elle l'illustre par la position de départ, avec les chances de gagner selon GNU Backgammon