Prompts : gabarits dans docs/prompts/ et remplissage par le domaine

Cinq gabarits sous CC BY-SA 4.0 (coup, videau, bilan, concept,
exercices), remplis par des fonctions pures de domain/prompts/ avec la
position lue par le moteur (identifiants, lien public, diagramme) et ses
chiffres, écrits comme à l'écran (domain/analysis/numbers.ts, partagé avec
la feuille du maître, le bilan et l'analyse). Testés sur de vraies
analyses : aucun repère vide ni inconnu, mêmes chiffres que l'écran.
Fiche du glossaire « Prompt ».

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

docs/prompts/README.md

@@ -0,0 +1,58 @@
+# Les prompts à copier pour une IA
+
+Les textes que l'application copie dans le presse-papiers quand on touche
+« Demander à une IA » (étape 1f ; `docs/cadrage.md`, « IA générative en
+V1 »). L'application n'appelle aucune IA : elle prépare une question
+complète, que le joueur colle dans l'IA de son choix. Règle d'or : **le
+moteur décide, l'IA explique**.
+
+Une seule source (ADR 0008) : `make site` copie ce dossier dans le site
+publié (`docs/prompts/`), l'application lit les gabarits à l'exécution
+(`app/src/domain/prompts/`), et `make test` remplit chacun d'eux avec de
+vraies analyses du moteur (`app/tests/prompts.test.ts`) : aucun repère
+laissé vide, et les chiffres du prompt sont ceux que l'application affiche.
+
+Textes sous licence **CC BY-SA 4.0**. Version 1, rédigée par Claude Code
+d'après le cadrage, **à relire** par Pierre.
+
+## Les gabarits
+
+| Fichier | Bouton | Où |
+| --- | --- | --- |
+| [coup.md](coup.md) | Pourquoi ce coup est meilleur | Feuille du maître, bilan, analyse |
+| [videau.md](videau.md) | Expliquer cette décision de videau | Feuille du maître, bilan, analyse |
+| [bilan.md](bilan.md) | Bilan de ma partie | Bilan de fin de partie |
+| [concept.md](concept.md) | Expliquer ce concept | Fiche d'un terme du glossaire |
+| [exercices.md](exercices.md) | Créer des exercices | Progression (étape 1h, pas encore de bouton) |
+
+Chaque prompt contient :
+
+- le rôle de l'IA (un coach) et le niveau du joueur ;
+- la position : Position ID et Match ID de GNU Backgammon, le lien qui
+  l'ouvre dans l'application (`https://ustagammon.sans.pub/#/position/…`,
+  ADR 0013) et un diagramme texte dessiné d'après le plateau décodé par le
+  moteur ;
+- les chiffres du moteur, avec le niveau d'évaluation (en plis) ;
+- la consigne de ne pas recalculer ni contredire ces chiffres ;
+- la langue de la réponse.
+
+## Format
+
+Dans chaque fichier, le gabarit est le bloc de texte qui suit le titre
+`## Gabarit`. Le reste du fichier n'est pas lu. Les mots entre accolades sont
+remplis par l'application ; un repère inconnu ou une valeur vide est une
+erreur, vérifiée par les tests.
+
+Repères communs à plusieurs gabarits :
+
+| Repère | Ce qu'il devient |
+| --- | --- |
+| `{niveau}` | le niveau du joueur, d'après son taux d'erreur mesuré par GNU Backgammon, ou « pas encore mesuré » |
+| `{position_id}`, `{match_id}` | les identifiants de GNU Backgammon de la position |
+| `{au_trait}` | « moi » ou « l'ordinateur » : celui dont les identifiants décrivent le point de vue |
+| `{lien}` | l'adresse de la position dans l'application publiée |
+| `{diagramme}` | le plateau en texte : vos pions X, ceux de l'ordinateur O, dans votre numérotation |
+| `{score}` | « partie libre » ou le score du match |
+| `{videau}` | sa valeur et qui le possède |
+| `{niveau_eval}` | le niveau d'évaluation de GNU Backgammon, « analyse à 2 plis » |
+| `{langue}` | la langue de la réponse : « français » |