Files
Ustagammon/docs/prompts/README.md
T
Pierre MARTINandClaude Opus 5.5 4f0611c24c 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>
2026-11-10 20:40:07 +01:00

2.9 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 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 »