Files
Ustagammon/docs/prompts
Pierre MARTINandClaude Opus 5.5 c2c5d13651 Recette 1h : courbe, lignes de partie, en-tête, bouton des exercices, carte de l'accueil
Dernier point plus gros, vert seulement si le taux baisse ; valeurs au
premier et au dernier point, axe réduit à la ligne du 0. Une ligne de
partie = un lien vers le bilan, résultat court, date et niveau en
caption. Plus de « Retour », titre en h1 ; « Nouvelle partie » pleine
largeur en portrait ; « Demander des exercices à une IA ». La carte de
l'accueil sans partie en cours ne montre plus la partie finie (testé).
Phrase progression.hausse sans « un peu ». L'écran relit ses parties à
chaque visite sans montrer celles de la précédente. Test navigateur sur
trois courses jouées jusqu'au bout.

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

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 Demander des exercices à une IA Écran de progression (étape 1h)

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 »