# 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.