pierre/Ustagammon
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Activity

Demander à une IA : prompts à copier depuis le maître, le bilan, l'analyse et le glossaire (1f) #56

Manually merged
pierre merged 6 commits from prompts into main 2026-11-11 21:33:35 +00:00
Conversation 0 Commits 6 Files Changed 42
+3441 -109
pierre commented 2026-11-11 21:28:33 +00:00
Owner
Copy Link
Copy Source

Pourquoi

La V1 ne fait aucun appel réseau (cadrage, section « IA générative en V1 »). Pourtant, un débutant qui lit « J'aurais joué 8/5 6/5 » veut savoir pourquoi, et le maître ne cite que des faits.

La sous-étape 1f lui donne une question toute prête, remplie avec les chiffres de GNU Backgammon, à coller dans l'IA de son choix. Le moteur décide, l'IA explique.

Quoi

  • Bouton « Demander à une IA », en secondaire, à quatre endroits :
    • la feuille du maître ;
    • la carte « Le coup à revoir » du bilan ;
    • le visualiseur de l'analyse ;
    • la fiche ouverte du glossaire.
  • Feuille du prompt. Elle a sa propre adresse (…/ia), et le texte s'y relit avant d'être copié.
  • Une seule feuille à la fois.
    • Depuis la feuille du maître ou le bilan, le prompt prend leur place à la même hauteur, avec « ‹ Explication » ou « ‹ Bilan » pour revenir.
    • Depuis l'analyse ou le glossaire, il monte dans sa propre feuille.
    • Le retour du téléphone, Échap et « ‹ … » ramènent à l'écran d'avant.
  • Copie confirmée sur le bouton : « ✓ Copié », en vert, pendant 2 s. Si le navigateur refuse la copie, le texte est sélectionné pour une copie à la main.
  • Niveau du joueur. Le prompt ne le donne qu'à partir de 20 décisions analysées. En dessous, il dit « Je débute au backgammon. ». Le taux d'erreur ne figure que dans le prompt du bilan.

Comment

Le travail a été délégué à un sous-agent. Le premier agent s'est arrêté avec la fin de session ; un second a repris sa branche, avec l'accord de Pierre.

Gabarits. Cinq gabarits sous licence CC BY-SA 4.0, dans docs/prompts/ : coup, videau, bilan, concept, exercices. C'est une source unique, copiée dans le site par make site (ADR 0008).

Remplissage. Le domaine (app/src/domain/prompts/) remplit les gabarits à partir du journal et des analyses du moteur :

  • la position, avec Position ID, Match ID, lien public et diagramme texte dessiné d'après le plateau décodé par le moteur ;
  • le classement des coups, les appréciations et la chance.

Adresses et affichage.

  • Les adresses …/ia font l'objet d'un amendement de l'ADR 0013.
  • Pour garder exactement la même hauteur, la page du prompt se pose sur la feuille du maître ou le panneau du bilan. Tout passe par des classes CSS : la CSP stricte reste respectée.

Recette design. Elle a demandé trois corrections : la feuille unique, la confirmation sur le bouton et le seuil de 20 décisions. Les trois sont faites, puis validées par la session « identité ».

Vérification.

  • make lint : aucun problème.
  • make test : 10/10, 49 scénarios.
  • make test-browser, suite complète :
    • Chromium passe partout, prompts compris, avec lecture du presse-papiers.
    • Sous Firefox, play.mjs a échoué une fois sur « la nouvelle partie n'a pas été enregistrée », puis est passé à la relance. Ce test n'est pas modifié par cette MR, et l'écriture IndexedDB de Firefox est déjà connue pour être lente sous charge. Deux suites de tests tournaient alors en même temps sur la machine. L'aléa est noté pour une correction à part.

Choix et compromis

  • Superposition plutôt que hauteur fixe. La page du prompt couvre la feuille existante, alors qu'une hauteur fixée en CSS ne garantissait pas la même taille. Revers : avec une explication courte, la zone de texte est courte aussi, mais elle défile.
  • Croix et retour. La croix ferme aussi la feuille du maître ; c'est « ‹ Explication » qui y ramène.
  • Seuil de 20 décisions. C'est une constante (LEVEL_MIN_DECISIONS). L'historique (1h) pourra cumuler les décisions de plusieurs parties.
  • Aucune nouvelle dépendance.

Risques et déploiement

  • Données. Aucune donnée stockée ne change.
  • Gabarits. Modifier un gabarit change le prompt sans toucher au code. Les tests vérifient qu'aucun repère {…} ne reste vide.
  • Retour arrière. Annuler la fusion.

Comment vérifier

make lint && make test && make test-browser
ls build/browser-shots/prompts/

Sur le téléphone :

  1. Jouer une erreur, toucher la ligne du maître, puis « Demander à une IA » : une seule feuille s'affiche, avec « ‹ Explication ».
  2. Toucher « Copier le prompt » : le bouton passe à « ✓ Copié ».

Hors périmètre

  • Prompt « exercices ». Il n'a pas encore de bouton : il attend l'historique (1h).
  • Niveau d'évaluation incohérent. Dans le prompt d'un coup, le titre dit « analyse à 2 plis » mais chaque ligne dit « évalué à 1 pli ». À vérifier et corriger à part : le prompt doit dire exactement ce que le moteur a calculé.
  • Aléa sous Firefox. L'échec de play.mjs dans « mes parties » reste à traiter à part.
  • Largeur du bouton. Elle change entre « Copier le prompt » et « ✓ Copié ».

Generated with Claude Code https://claude.com/claude-code

## Pourquoi La V1 ne fait aucun appel réseau (cadrage, section « IA générative en V1 »). Pourtant, un débutant qui lit « J'aurais joué 8/5 6/5 » veut savoir pourquoi, et le maître ne cite que des faits. La sous-étape 1f lui donne une question toute prête, remplie avec les chiffres de GNU Backgammon, à coller dans l'IA de son choix. Le moteur décide, l'IA explique. ## Quoi - **Bouton « Demander à une IA »**, en secondaire, à quatre endroits : - la feuille du maître ; - la carte « Le coup à revoir » du bilan ; - le visualiseur de l'analyse ; - la fiche ouverte du glossaire. - **Feuille du prompt.** Elle a sa propre adresse (`…/ia`), et le texte s'y relit avant d'être copié. - **Une seule feuille à la fois.** - Depuis la feuille du maître ou le bilan, le prompt prend leur place à la même hauteur, avec « ‹ Explication » ou « ‹ Bilan » pour revenir. - Depuis l'analyse ou le glossaire, il monte dans sa propre feuille. - Le retour du téléphone, Échap et « ‹ … » ramènent à l'écran d'avant. - **Copie confirmée sur le bouton** : « ✓ Copié », en vert, pendant 2 s. Si le navigateur refuse la copie, le texte est sélectionné pour une copie à la main. - **Niveau du joueur.** Le prompt ne le donne qu'à partir de 20 décisions analysées. En dessous, il dit « Je débute au backgammon. ». Le taux d'erreur ne figure que dans le prompt du bilan. ## Comment Le travail a été délégué à un sous-agent. Le premier agent s'est arrêté avec la fin de session ; un second a repris sa branche, avec l'accord de Pierre. **Gabarits.** Cinq gabarits sous licence CC BY-SA 4.0, dans `docs/prompts/` : coup, videau, bilan, concept, exercices. C'est une source unique, copiée dans le site par `make site` (ADR 0008). **Remplissage.** Le domaine (`app/src/domain/prompts/`) remplit les gabarits à partir du journal et des analyses du moteur : - la position, avec Position ID, Match ID, lien public et diagramme texte dessiné d'après le plateau décodé par le moteur ; - le classement des coups, les appréciations et la chance. **Adresses et affichage.** - Les adresses `…/ia` font l'objet d'un amendement de l'ADR 0013. - Pour garder exactement la même hauteur, la page du prompt se pose sur la feuille du maître ou le panneau du bilan. Tout passe par des classes CSS : la CSP stricte reste respectée. **Recette design.** Elle a demandé trois corrections : la feuille unique, la confirmation sur le bouton et le seuil de 20 décisions. Les trois sont faites, puis validées par la session « identité ». **Vérification.** - `make lint` : aucun problème. - `make test` : 10/10, 49 scénarios. - `make test-browser`, suite complète : - Chromium passe partout, prompts compris, avec lecture du presse-papiers. - Sous Firefox, `play.mjs` a échoué une fois sur « la nouvelle partie n'a pas été enregistrée », puis est passé à la relance. Ce test n'est pas modifié par cette MR, et l'écriture IndexedDB de Firefox est déjà connue pour être lente sous charge. Deux suites de tests tournaient alors en même temps sur la machine. L'aléa est noté pour une correction à part. ## Choix et compromis - **Superposition plutôt que hauteur fixe.** La page du prompt couvre la feuille existante, alors qu'une hauteur fixée en CSS ne garantissait pas la même taille. Revers : avec une explication courte, la zone de texte est courte aussi, mais elle défile. - **Croix et retour.** La croix ferme aussi la feuille du maître ; c'est « ‹ Explication » qui y ramène. - **Seuil de 20 décisions.** C'est une constante (`LEVEL_MIN_DECISIONS`). L'historique (1h) pourra cumuler les décisions de plusieurs parties. - **Aucune nouvelle dépendance.** ## Risques et déploiement - **Données.** Aucune donnée stockée ne change. - **Gabarits.** Modifier un gabarit change le prompt sans toucher au code. Les tests vérifient qu'aucun repère `{…}` ne reste vide. - **Retour arrière.** Annuler la fusion. ## Comment vérifier ``` make lint && make test && make test-browser ls build/browser-shots/prompts/ ``` Sur le téléphone : 1. Jouer une erreur, toucher la ligne du maître, puis « Demander à une IA » : une seule feuille s'affiche, avec « ‹ Explication ». 2. Toucher « Copier le prompt » : le bouton passe à « ✓ Copié ». ## Hors périmètre - **Prompt « exercices ».** Il n'a pas encore de bouton : il attend l'historique (1h). - **Niveau d'évaluation incohérent.** Dans le prompt d'un coup, le titre dit « analyse à 2 plis » mais chaque ligne dit « évalué à 1 pli ». À vérifier et corriger à part : le prompt doit dire exactement ce que le moteur a calculé. - **Aléa sous Firefox.** L'échec de `play.mjs` dans « mes parties » reste à traiter à part. - **Largeur du bouton.** Elle change entre « Copier le prompt » et « ✓ Copié ». Generated with Claude Code https://claude.com/claude-code
pierre added 6 commits 2026-11-11 21:28:34 +00:00
Prompts : gabarits dans docs/prompts/ et remplissage par le domaine 4f0611c24c 
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>
« Demander à une IA » : bouton, feuille du prompt à son adresse, copie 2a1fe1b04c 
Le bouton, secondaire, dans la feuille du maître, sur le bilan, dans
l'analyse et sur la fiche ouverte du glossaire. Il ouvre la feuille du
prompt (…/ia, amendement de l'ADR 0013), où le texte se relit avant la
copie : navigator.clipboard, repli par sélection du texte, bandeau
« Prompt copié » (2 s). Gabarits copiés par make site (amendement de
l'ADR 0008), scénario « Demander à une IA », 1f marquée faite.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Test navigateur des prompts : captures sans bandeau résiduel, repli par sélection vérifié f509f8746e 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Prompts : le niveau du joueur seulement à partir de 20 décisions, son taux d'erreur dans le seul bilan f2df1b2e7f 
Recette de 1f (F3). En dessous de 20 décisions analysées, le prompt dit
« Je débute au backgammon. ». Test du seuil ; outil prompt-sample pour
relire des prompts remplis par le moteur. Plan de 1f clos.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Demander à une IA : une seule feuille à la fois, la copie confirmée sur le bouton d5f08fe393 
Recette de 1f (F1, F2). Depuis la feuille du maître ou le bilan, la page
du prompt prend la place de leur contenu, à la même hauteur, avec
« ‹ Explication » ou « ‹ Bilan » pour revenir ; depuis l'analyse et le
glossaire, elle monte dans sa propre feuille. La croix et « Fermer »
ferment la feuille. Plus de bandeau « Prompt copié » : le bouton passe à
« ✓ Copié » (verdict-good) 2 s. Test navigateur : une poignée, une croix,
un titre, même hauteur, retour du téléphone, couleur du bouton. Charte et
amendement de l'ADR 0013 mis à jour.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Merge remote-tracking branch 'origin/main' into prompts 850d860658
pierre manually merged commit 05bd06c946 into main 2026-11-11 21:33:35 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
pierre (Pierre Martin)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: pierre/Ustagammon#56