Fusion de la MR !63 : progression, courbe du taux d'erreur, parties terminées, exercices (1h)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit was merged in pull request #63.
This commit is contained in:
Pierre MARTIN
Claude Opus 5.5
@@ -218,3 +218,29 @@ sur le modèle du tutoriel :
|
||||
liste après la dernière. Le menu a une ligne « Les leçons ».
|
||||
- Ces adresses se partagent : le contenu des leçons est le même pour tous ;
|
||||
seule la progression (barre, état) dépend de l'appareil.
|
||||
|
||||
### 2026-11-12 — Adresses de la progression
|
||||
|
||||
Ajoutées avec l'écran de progression (étape 1h), dans le même schéma :
|
||||
|
||||
| Écran | Adresse |
|
||||
| --- | --- |
|
||||
| Progression : courbe du taux d'erreur et parties terminées | `#/progression` |
|
||||
| Prompt « Demander des exercices à une IA », depuis la progression | `#/progression/ia` |
|
||||
|
||||
- La ligne de progression de l'accueil est un lien vers `#/progression`.
|
||||
L'écran est une page, comme la liste des leçons : pas de bouton
|
||||
« Retour », la barre du haut, Échap et le retour du téléphone suffisent.
|
||||
Échap revient à l'écran d'avant, l'accueil s'il a été ouvert par son
|
||||
adresse.
|
||||
- Chaque partie de la liste est un lien vers son bilan
|
||||
(`#/parties/<id>/bilan`), d'où s'ouvre son analyse. Fermer le bilan
|
||||
ramène à la progression.
|
||||
- « Demander des exercices à une IA » suit la règle des prompts (amendement du
|
||||
2026-11-10) : le bouton ouvre la feuille du prompt, dans sa propre
|
||||
feuille au-dessus de la progression (« ‹ Progression »), où le texte se
|
||||
relit avant d'être copié. Rechargée, l'adresse recalcule le prompt à
|
||||
partir des analyses enregistrées ; sans partie analysée, ou sans erreur,
|
||||
la feuille le dit, jamais une page cassée.
|
||||
- Comme « Mes parties », ces adresses n'ont de sens que sur l'appareil qui
|
||||
a joué les parties : ce ne sont pas des liens à partager.
|
||||
|
||||
+1
-1
@@ -24,7 +24,7 @@ Repris du cadrage (modules, écrans clés, IA générative en V1) et des ADR 001
|
||||
| 1e. Fin de partie et analyse (fait) | Bilan (ADR 0011) : résultat, coups par appréciation, taux d'erreur comparé à la chance, « le coup à revoir » ; écran d'analyse : graphe d'équité (toucher un point ouvre la position), liste des erreurs filtrable, visualiseur pas à pas coup joué contre meilleur coup, « Rejouer d'ici » | 1a, 1b, 1d |
|
||||
| 1f. Prompts à copier (fait) | Gabarits versionnés et testés (`docs/prompts/` ou équivalent, source unique), bouton « Demander à une IA » sur le plateau, le conseil du maître, l'analyse et la fin de partie ; le moteur décide, l'IA explique | 1d, 1e |
|
||||
| 1g. Accueil, tutoriel et leçons (fait) | Accueil (reprendre, nouvelle partie, prochaine leçon, progression résumée), tutoriel des règles interactif et illustré (0e.5), cinq premières leçons numérotées (ADR 0011) avec positions et « à vous de jouer », progression locale ; contenus CC BY-SA 4.0 livrés sans relecture préalable, sous les garde-fous du moteur (décision du 2026-11-09) | 0e.5, 1a |
|
||||
| 1h. Progression | Historique des parties et courbe du taux d'erreur | 1b, 1e |
|
||||
| 1h. Progression (fait) | Historique des parties et courbe du taux d'erreur | 1b, 1e |
|
||||
| 1i. Plateau soigné | Dessin du plateau aligné sur la charte (`docs/identite/charte/board.js`), animations des pions, glisser-déposer en plus du toucher, double toucher pour le seul coup évident | 0e.3 |
|
||||
| 1k. Retours des joueurs, 2e lot | Crawford signalé sur la barre ; abandon (simple, gammon, backgammon) accepté ou refusé par l'ordinateur selon GNU Backgammon (plan `2026-11-12-retours-joueurs-2.md`) | 1c, 1e |
|
||||
| 1l. Analyse du match | Bilan et courbe d'un match entier (chances de gagner le match), erreurs de videau sur tout le match, prompt et export SGF du match (plan `2026-11-12-analyse-du-match.md`) | 1c, 1e, 1f |
|
||||
|
||||
@@ -27,6 +27,10 @@ les noms des niveaux de l'ordinateur, dans le même ordre :
|
||||
| 0,020 à 0,032 | Intermediate | Amateur |
|
||||
| 0,032 et plus | Beginner | Débutant |
|
||||
|
||||
L'écran de progression l'écrit en millièmes, comme GNU Backgammon (« mEMG ») :
|
||||
14 veut dire 0,014 d'équité perdue par décision. Sa courbe montre ce taux
|
||||
partie après partie ; plus elle descend, mieux vous jouez.
|
||||
|
||||
Le bilan montre à côté la [chance](chance.md) de vos dés sur la partie : par
|
||||
tour, la chance de vos jets ; « un peu » pour vous ou contre vous au-delà de
|
||||
0,03 par tour, « nettement » au-delà de 0,06, comme GNU Backgammon. La
|
||||
|
||||
+33
-2
@@ -1,7 +1,7 @@
|
||||
# Les phrases du maître
|
||||
|
||||
Les mots et les phrases du conseil du maître (étape 1d) et du bilan de fin
|
||||
de partie (étape 1e), en une seule source (ADR 0008) : `make site` copie ce
|
||||
Les mots et les phrases du conseil du maître (étape 1d), du bilan de fin
|
||||
de partie (étape 1e) et de l'écran de progression (étape 1h), en une seule source (ADR 0008) : `make site` copie ce
|
||||
dossier dans le site publié
|
||||
(`docs/maitre/`), l'application le lit à l'exécution
|
||||
(`app/src/domain/analysis/phrases.ts`), et `make test` rend chaque gabarit
|
||||
@@ -39,6 +39,9 @@ mots entre accolades sont remplis avec les données du moteur :
|
||||
| `{roll}` | le jet, « 3-1 » |
|
||||
| `{hits}` | le nombre de pions frappés, en chiffres |
|
||||
| `{dice}` | la chance de vos dés sur la partie, en mots (bilan, étape 1e) |
|
||||
| `{parties}` | le nombre de parties analysées sur la courbe (progression, étape 1h) |
|
||||
| `{debut}` | le taux d'erreur moyen de la plus ancienne moitié de ces parties, en millièmes (14 pour 0,014) |
|
||||
| `{fin}` | le même, sur la plus récente moitié |
|
||||
|
||||
Un fait (sections `fait.…`) s'ajoute à la phrase seulement si la ligne reste
|
||||
sous 140 caractères.
|
||||
@@ -281,3 +284,31 @@ erreurs.
|
||||
## bilan.aucun-coup
|
||||
|
||||
- Aucun coup à revoir : vous avez joué comme je l'aurais fait.
|
||||
|
||||
## progression.baisse
|
||||
|
||||
Écran de progression (étape 1h), au moins trois parties analysées : le
|
||||
taux d'erreur moyen de la plus récente moitié des parties est plus bas que
|
||||
celui de la plus ancienne (moyennes arrondies en millièmes ; la partie du
|
||||
milieu, quand leur nombre est impair, ne compte dans aucune).
|
||||
|
||||
- Sur vos {parties} dernières parties, vous faites moins d'erreurs : votre taux d'erreur est passé de {debut} à {fin}.
|
||||
|
||||
## progression.hausse
|
||||
|
||||
Le taux moyen remonte : la phrase reste encourageante, sans reproche, sans
|
||||
minimiser ni dramatiser.
|
||||
|
||||
- Sur vos {parties} dernières parties, votre taux d'erreur remonte, de {debut} à {fin}. Les leçons sont là pour reprendre un point.
|
||||
|
||||
## progression.stable
|
||||
|
||||
Les deux moyennes, arrondies, sont égales.
|
||||
|
||||
- Sur vos {parties} dernières parties, votre taux d'erreur reste à {fin}.
|
||||
|
||||
## progression.attente
|
||||
|
||||
Moins de trois parties analysées : pas encore de courbe.
|
||||
|
||||
- Votre courbe apparaîtra après trois parties.
|
||||
|
||||
@@ -1,30 +0,0 @@
|
||||
# Progression (1h)
|
||||
|
||||
- **Date** : 2026-11-03
|
||||
- **Étape** : 1h (`docs/etape-1.md`)
|
||||
- **Statut** : prévu (après 1e)
|
||||
- **Exécutant** : sous-agent general-purpose, dans un worktree
|
||||
|
||||
## Objectif
|
||||
|
||||
Mettre en place la progression du cadrage pour la V1 : l'historique des parties et la courbe du taux d'erreur.
|
||||
|
||||
## Consignes
|
||||
|
||||
1. **Écran `#/progression`.** Il est conforme à la charte et s'ajoute au tableau de l'ADR 0013. Il montre :
|
||||
- la courbe du taux d'erreur par partie terminée, en SVG à la main, sans dépendance ;
|
||||
- la liste des parties, reliée à leur bilan et à leur analyse (1e) ;
|
||||
- un résumé en une phrase.
|
||||
2. **Accueil.** Il reçoit la « ligne de progression » de la charte.
|
||||
3. **Données.** Elles proviennent des analyses enregistrées : rien n'est recalculé si l'analyse existe. Une partie non analysée est analysée en arrière-plan.
|
||||
4. **Tests.**
|
||||
- Scénarios Gherkin.
|
||||
- `make lint`, `make test`, `make test-browser` avec trois parties jouées, et captures.
|
||||
|
||||
## Critères de réussite
|
||||
|
||||
Après trois parties, la courbe a trois points égaux aux taux d'erreur des bilans. Les trois commandes passent.
|
||||
|
||||
## Résultat
|
||||
|
||||
À remplir à la clôture.
|
||||
@@ -23,7 +23,7 @@ d'après le cadrage, **à relire** par Pierre.
|
||||
| [videau.md](videau.md) | Expliquer cette décision de videau | Feuille du maître, bilan, analyse |
|
||||
| [bilan.md](bilan.md) | Bilan de ma partie | Bilan de fin de partie |
|
||||
| [concept.md](concept.md) | Expliquer ce concept | Fiche d'un terme du glossaire |
|
||||
| [exercices.md](exercices.md) | Créer des exercices | Progression (étape 1h, pas encore de bouton) |
|
||||
| [exercices.md](exercices.md) | Demander des exercices à une IA | Écran de progression (étape 1h) |
|
||||
|
||||
Chaque prompt contient :
|
||||
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
# Créer des exercices
|
||||
|
||||
Prévu pour l'écran de progression (étape 1h) : le gabarit est écrit et
|
||||
testé, sans bouton pour l'instant. Il rassemble les erreurs de vos
|
||||
dernières parties analysées. Texte sous licence CC BY-SA 4.0 (voir
|
||||
Le bouton « Demander des exercices à une IA » de l'écran de progression (étape 1h,
|
||||
`#/progression/ia`). Il rassemble les erreurs de vos dernières parties
|
||||
analysées (les 20 plus récentes au plus), et ce qui y revient. Texte sous licence CC BY-SA 4.0 (voir
|
||||
[README.md](README.md)).
|
||||
|
||||
Repères propres à ce gabarit :
|
||||
@@ -11,6 +11,7 @@ Repères propres à ce gabarit :
|
||||
| --- | --- |
|
||||
| `{parties}` | le nombre de parties analysées |
|
||||
| `{erreurs}` | vos erreurs les plus coûteuses sur ces parties, avec leur coût |
|
||||
| `{themes}` | ce qui revient dans toutes vos imprécisions et erreurs de ces parties, compté sur les plateaux décodés par le moteur : combien de coups et de décisions de videau ; combien de fois le coup du maître frappait un pion et le vôtre non, faisait un point que le vôtre ne faisait pas, ou l'inverse (votre coup frappait, le sien non) |
|
||||
| `{position_titre}` | la plus coûteuse d'entre elles |
|
||||
|
||||
## Gabarit
|
||||
@@ -23,6 +24,9 @@ Voici mes {parties} dernières parties contre l'ordinateur, analysées par GNU B
|
||||
Mes erreurs les plus coûteuses, avec leur coût en équité :
|
||||
{erreurs}
|
||||
|
||||
Ce qui revient dans ces erreurs, compté sur les plateaux décodés par GNU Backgammon :
|
||||
{themes}
|
||||
|
||||
{position_titre} (GNU Backgammon, Position ID : {position_id}, Match ID : {match_id} ; ces identifiants la décrivent du point de vue du joueur qui a la main : {au_trait}).
|
||||
Elle s'ouvre aussi à cette adresse : {lien}
|
||||
|
||||
|
||||
@@ -66,4 +66,5 @@ Règles d'écriture :
|
||||
| [decouvrir-l-application.feature](decouvrir-l-application.feature) | Premier lancement et accueil | Étape 0e.5 |
|
||||
| [apprendre-les-regles.feature](apprendre-les-regles.feature) | Apprendre les règles avec le tutoriel | Étape 0e.5 |
|
||||
| [suivre-une-lecon.feature](suivre-une-lecon.feature) | Progresser avec les leçons, garder sa progression | Étape 1g |
|
||||
| [suivre-ma-progression.feature](suivre-ma-progression.feature) | Suivre sa progression : courbe du taux d'erreur, parties, exercices | Étape 1h |
|
||||
| [installer-l-application.feature](installer-l-application.feature) | Installer l'application | Étape 0e.5 |
|
||||
|
||||
@@ -0,0 +1,57 @@
|
||||
# language: fr
|
||||
Fonctionnalité: Suivre ma progression
|
||||
|
||||
« Votre progression », depuis la ligne de progression de l'accueil, montre
|
||||
votre taux d'erreur partie après partie : plus il est bas, mieux vous avez
|
||||
joué. Chaque partie terminée y figure avec son résultat, sa date, le niveau
|
||||
de l'ordinateur et son taux d'erreur, celui de son bilan ; touchez-la pour
|
||||
rouvrir son bilan, et de là son analyse. Une phrase du maître dit, en chiffres,
|
||||
comment évolue votre taux d'erreur.
|
||||
|
||||
Scénario: Comment voir ma progression ?
|
||||
Après trois parties analysées, la courbe montre un point par partie, de
|
||||
la plus ancienne à la plus récente. Chaque point est le taux d'erreur du
|
||||
bilan de la partie, en millièmes : 14 veut dire que vous avez perdu en
|
||||
moyenne 0,014 d'équité par décision.
|
||||
|
||||
Étant donné que vous avez terminé trois parties contre l'ordinateur
|
||||
Et que le maître les a analysées
|
||||
Quand vous ouvrez votre progression
|
||||
Alors la courbe a trois points, chacun égal au taux d'erreur du bilan de sa partie
|
||||
Et la phrase du maître compare vos premières parties aux dernières
|
||||
|
||||
Scénario: Quand ma courbe apparaît-elle ?
|
||||
Il faut trois parties terminées et analysées. Avant, la liste de vos
|
||||
parties est déjà là, avec leur taux d'erreur.
|
||||
|
||||
Étant donné que vous avez terminé deux parties contre l'ordinateur
|
||||
Et que le maître les a analysées
|
||||
Quand vous ouvrez votre progression
|
||||
Alors il n'y a pas encore de courbe
|
||||
Et la phrase de votre progression est « Votre courbe apparaîtra après trois parties. »
|
||||
|
||||
Scénario: Et une partie que le maître n'a pas encore analysée ?
|
||||
Elle est analysée en arrière-plan quand vous ouvrez votre progression, et
|
||||
elle rejoint la courbe dès que son analyse est finie. Les parties déjà
|
||||
analysées ne sont jamais recalculées.
|
||||
|
||||
Étant donné que vous avez terminé trois parties contre l'ordinateur
|
||||
Et que le maître n'a analysé que les deux premières
|
||||
Quand vous ouvrez votre progression
|
||||
Alors la troisième partie attend son analyse, sans taux d'erreur
|
||||
Quand son analyse en arrière-plan est finie
|
||||
Alors la courbe a trois points, chacun égal au taux d'erreur du bilan de sa partie
|
||||
Et les deux premières parties n'ont pas été analysées de nouveau
|
||||
|
||||
Scénario: Comment créer des exercices sur mes erreurs ?
|
||||
« Demander des exercices à une IA » prépare une question : vos erreurs
|
||||
les plus coûteuses sur vos dernières parties, avec leur coût selon le
|
||||
maître, ce qui y revient (pions frappés, points faits par le coup du
|
||||
maître et pas par le vôtre), et la position de la plus coûteuse. Votre
|
||||
niveau n'y figure qu'à partir de 20 décisions analysées en tout.
|
||||
|
||||
Étant donné que vous avez terminé trois parties contre l'ordinateur
|
||||
Et que le maître les a analysées
|
||||
Quand vous demandez des exercices
|
||||
Alors la question cite vos erreurs avec leur coût et ce qui y revient
|
||||
Et elle ne donne votre niveau que si vos parties comptent au moins 20 décisions
|
||||
Reference in New Issue
Block a user