ADR 0011 : leçons numérotées, conseil du maître, bilan de fin de partie #16

2026-11-03T00:53:49Z

pierre commented

2026-11-03 00:53:49 +00:00

Pourquoi

Les maquettes des écrans (https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe), faites avec la charte graphique, proposaient trois fonctions d'apprentissage : des leçons numérotées, un « Conseil du maître » et un bilan de fin de partie. Le 2026-11-03, Pierre les a retenues toutes les trois. Ce sont des choix de produit : ils doivent être consignés dans un ADR avant toute mise en œuvre.

Un point contredisait le cadrage : dans la maquette, le conseil apparaissait avant le coup et donnait la réponse, alors que le cadrage prévoit un coach qui commente après chaque coup. Pierre a tranché : le conseil vient après le coup.

Quoi

L'ADR 0011 décrit les trois fonctions, les alternatives écartées et leurs conséquences techniques.
La feuille de route précise le contenu de l'étape 1 (V1) : charte appliquée à la PWA, conseil du maître, bilan de fin de partie, premières leçons numérotées.
La maquette du plateau est corrigée sur claude.ai : le conseil commente désormais le coup précédent.

Le code ne change pas.

Comment

Ces fonctions précisent des éléments déjà prévus par docs/cadrage.md (coach en direct, écran de fin de partie, leçons par concept). L'ADR fixe leur forme, sans changer le périmètre de la V1.

Choix et compromis

Le conseil avant le coup, qui donnait la réponse, est écarté : le joueur n'essaie plus par lui-même.
Un indice avant le coup, sans la réponse, n'est pas décidé ici. Il reste à concevoir.

Risques et déploiement

Aucun : il n'y a que de la documentation. Pour revenir en arrière, il suffit d'annuler le commit de fusion.

Comment vérifier

make lint
make test

Hors périmètre

Restent à décider ou à faire : les seuils entre bon coup, imprécision et erreur ; le contenu des leçons et leur relecture par un joueur fort ; le temps d'analyse d'un coup sur le téléphone.

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

## Pourquoi Les maquettes des écrans (https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe), faites avec la charte graphique, proposaient trois fonctions d'apprentissage : des leçons numérotées, un « Conseil du maître » et un bilan de fin de partie. Le 2026-11-03, Pierre les a retenues toutes les trois. Ce sont des choix de produit : ils doivent être consignés dans un ADR avant toute mise en œuvre. Un point contredisait le cadrage : dans la maquette, le conseil apparaissait avant le coup et donnait la réponse, alors que le cadrage prévoit un coach qui commente après chaque coup. Pierre a tranché : le conseil vient après le coup. ## Quoi - L'ADR 0011 décrit les trois fonctions, les alternatives écartées et leurs conséquences techniques. - La feuille de route précise le contenu de l'étape 1 (V1) : charte appliquée à la PWA, conseil du maître, bilan de fin de partie, premières leçons numérotées. - La maquette du plateau est corrigée sur claude.ai : le conseil commente désormais le coup précédent. Le code ne change pas. ## Comment Ces fonctions précisent des éléments déjà prévus par `docs/cadrage.md` (coach en direct, écran de fin de partie, leçons par concept). L'ADR fixe leur forme, sans changer le périmètre de la V1. ## Choix et compromis - Le conseil avant le coup, qui donnait la réponse, est écarté : le joueur n'essaie plus par lui-même. - Un indice avant le coup, sans la réponse, n'est pas décidé ici. Il reste à concevoir. ## Risques et déploiement Aucun : il n'y a que de la documentation. Pour revenir en arrière, il suffit d'annuler le commit de fusion. ## Comment vérifier make lint make test ## Hors périmètre Restent à décider ou à faire : les seuils entre bon coup, imprécision et erreur ; le contenu des leçons et leur relecture par un joueur fort ; le temps d'analyse d'un coup sur le téléphone. Generated with Claude Code (https://claude.com/claude-code)

pierre added 1 commit 2026-11-03 00:53:49 +00:00

ADR 0011 : leçons numérotées, conseil du maître, bilan de fin de partie a490e72409

Choix de Pierre sur les maquettes : parcours de leçons numérotées,
conseil du maître donné après le coup (jamais avant), bilan de fin de
partie avec le coup à revoir. Feuille de route mise à jour.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

pierre merged commit b08c4ffd54 into main

2026-11-03 00:54:14 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: pierre/Ustagammon#16