Files
Ustagammon/docs/prompts/README.md
Pierre MARTINandClaude Opus 5.5 99294900a0 Prompt d'un coup : le classement de l'analyse, au niveau calculé
Le classement du conseil vient de l'analyse du coup joué (conseils en
version 2) : mêmes équités que la feuille du maître et l'analyse. Le
titre dit le niveau du meilleur coup ; une ligne plus basse le dit aussi.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 02:47:38 +01:00

3.2 KiB

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 Pourquoi ce coup est meilleur Feuille du maître, bilan, analyse
videau.md Expliquer cette décision de videau Feuille du maître, bilan, analyse
bilan.md Bilan de ma partie Bilan de fin de partie
concept.md Expliquer ce concept Fiche d'un terme du glossaire
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 » ; pour un classement de coups, celui auquel le moteur a évalué le meilleur coup (voir coup.md)
{langue} la langue de la réponse : « français »