Ustagammon/docs/plans/2026-11-03-prompts.md

Prompts à copier (1f)

• Date : 2026-11-03
• Étape : 1f (docs/etape-1.md)
• Statut : prévu (après 1e)
• Exécutant : sous-agent general-purpose, dans un worktree

Objectif

Mettre en place la section « IA générative en V1 » du cadrage. Un bouton « Demander à une IA » copie un prompt rempli avec le contexte exact. Le moteur décide, l'IA explique. L'app n'appelle aucune IA.

Consignes

1. Gabarits. Les cinq gabarits du cadrage sont versionnés dans une source unique sous docs/prompts/, sous licence CC BY-SA 4.0 :

   • « pourquoi ce coup est meilleur » ;
   • « expliquer cette décision de videau » ;
   • « bilan de ma partie » ;
   • « expliquer ce concept » ;
   • « créer des exercices », à garder pour la progression.

   Chaque gabarit contient :

   • le rôle et le niveau du joueur ;
   • le Position ID et le Match ID ;
   • un diagramme texte de la position, produit à partir du plateau décodé par le moteur ;
   • les chiffres du moteur, avec le niveau d'évaluation ;
   • la consigne de ne pas contredire ces chiffres ;
   • la langue.

   Ajouter aussi le lien #/position/... de l'ADR 0013, avec l'adresse publique du site.

2. Remplissage. Une fonction pure remplit les gabarits. Elle est testée sur des analyses réelles du moteur : aucun champ vide ni {inconnu}, et les chiffres sont identiques à ceux du moteur.

3. Boutons. Ils sont placés sur le conseil du maître (feuille d'explication), le bilan, l'analyse et la fiche d'un terme du glossaire. La copie passe par navigator.clipboard, avec un repli de sélection du texte. Un bandeau « Prompt copié » l'accompagne, et le texte reste visible pour qui veut le relire.

4. Tests.

   • Scénarios Gherkin : copier le prompt d'une erreur, et celui d'un bilan.
   • make lint, make test et make test-browser, avec lecture du presse-papiers dans Chromium et captures.

Critères de réussite

Le prompt copié après une erreur contient la position, les identifiants gnubg et le top 3 du moteur avec les mêmes chiffres que l'app. Les trois commandes passent.

Résultat

À remplir à la clôture.