# 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, quand il est mesuré, 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 |
| --- | --- |
| `{joueur}` | « Je suis un joueur de niveau Avancé. », le niveau que donne GNU Backgammon d'après l'erreur par décision, seulement à partir de 20 décisions analysées ; en dessous, « Je débute au backgammon. ». Le taux d'erreur lui-même n'apparaît que dans le bilan. |
| `{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 » |