Skip to content

docs: pistes de rétention, ADR 0080 à 0083 et maquettes - #51

Merged
Lunik merged 6 commits into
masterfrom
claude/game-engagement-retention-lyk0n0
Oct 24, 2026
Merged

Lunik merged 6 commits into
masterfrom
claude/game-engagement-retention-lyk0n0

Conversation

@Lunik

@Lunik Lunik commented Oct 18, 2026 •

Copy link
Copy Markdown
Collaborator

Résumé

Cette PR consigne les quatre pistes de rétention retenues par le propriétaire. Elle contient la page de travail et ses démos, quatre ADR (proposés) et les maquettes. Le code correspondant est dans EtymoLogique/App#92, #93, #94 et #95, et dans EtymoLogique/Content#39.

Piste ADR Maquette PR
Enquêtes en cours : un indice acheté reste lisible 0080 I-09, I-12 App#92
Mémoire des essais : les briques déjà essayées passent en fin de réserve 0081 I-09 App#94
Quêtes de collection par fascicule 0082 démo de la page de travail App#95, Content#39
Vue Réseau du codex : la constellation en deux rives 0083 I-35 (nouvelle) App#93

Ce que contient la PR

  • docs/pistes-retention.html : la page de travail hors navigation, avec un diagnostic, les fondations à livrer d’abord, une démo jouable par piste, la constellation en situation (téléphone et ordinateur), un ordre de livraison et les écarts relevés en chemin. Les démos utilisent de vrais mots de Rosette et d’Argile, sans légendaire.
  • ADR 0080 à 0083, tous proposés :
    • l’ADR 0081 remplace en partie l’ADR 0027 : « les propositions de fusion ne sont jamais stockées » devient « la paire d’un échec ou d’un “presque” est gardée, sans issue ni date, jusqu’à la parution suivante » ;
    • l’ADR 0082 retient la rareté plutôt que la difficulté, que l’ADR 0047 interdit d’afficher.
  • Propagation :
    • index des ADR, statut de l’ADR 0027, renvois XREFS, adr.html régénéré ;
    • game-design.md : mémoire des essais, vue Réseau, quêtes de collection, et la section « Indices » réécrite selon l’ADR 0051 ;
    • modèle de données : nouvelle table essai, « Ce qui n’est jamais stocké » mis à jour.
  • Maquettes :
    • I-09 redessinée : réserve en feuille avec la mémoire des essais, enquêtes sous la table ;
    • I-12 redessinée : trois indices à la carte, conformes à l’ADR 0051 ; l’ancienne version à cinq niveaux est retirée ;
    • I-35 nouvelle : vue Réseau. Elle est aussi ajoutée à interfaces.html et à AGENTS.md.
  • Visuels pour les issues App, dans docs/assets/pistes-retention/.

Écarts relevés, non corrigés ici

  • game-design.md écarte « un mot découvert qui deviendrait une brique sans compteur d’exemplaires », alors que la roadmap de l’App en fait une brique qui ne se consomme jamais. Aucun ADR ne tranche.
  • design-system.html (§ 3.5) montre encore une « piste » de sens sur une carte inconnue, que l’ADR 0051 a retirée.
  • Le 3ᵉ jalon de chaque fascicule compte les mots légendaires, ce qui laisse deviner leur nombre ; c’est noté dans App#95.

Vérifications

  • build_adr : 77 ADR écrits.
  • check_identity --base origin/master : 0 erreur, 0 avertissement sur les lignes modifiées.
  • rule-verification :
    • vocabulaire du glossaire ;
    • un essai ne consomme rien ;
    • le serveur fait foi ;
    • jamais de légendaire ni de fascicule verrouillé ;
    • aucune difficulté affichée.
  • Captures Playwright de I-09, I-12 et I-35, à 1 440 px et 390 px, en atelier et en nocturne : aucune erreur dans la console. Les débordements à 390 px (pastilles de navigation, I-14, I-18, I-26) existent déjà sur master.

🤖 Generated with Claude Code

https://claude.ai/code/session_0151stDRaZV3ScbhwvwjrfQ7

Off-navigation working page (like logo.html and cartes-visuels.html):
diagnosis of what slows the game today, the measurement groundwork to
ship first (J5, scheduled aggregates, J7), and four ideas, each with a
demo built on Rosette and Argile words extracted from the Content repo
(legendaries excluded):

- the reserve as a prefix x suffix grid that remembers past attempts;
- the square, a daily table quest solved by analogy;
- the choice fold, two bricks offered and one kept;
- the constellation, the codex drawn as a network of families.

None of them is decided; each needs its own ADR. The page also flags a
gap between game-design.md (rejected ideas) and the App roadmap on
ingredient words whose brick is never consumed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0151stDRaZV3ScbhwvwjrfQ7
The owner reviewed the retention working page and rejected the choice
fold, the reserve shown as a prefix x suffix grid, the cross-word
announcement at reveal, chronology and example-based ricochets, and
special out-of-calendar fascicules. Add them to the rejected list of
game-design.md and mark the special fascicules track as rejected in
potentiel-evolution.md, so they only come back through an ADR.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0151stDRaZV3ScbhwvwjrfQ7
Second version of the retention page, following the owner's review:

- attempt memory: small badges on reserve bricks already tried with
  the brick on the table, kept by the server and wiped at each release
  (replaces the prefix x suffix grid);
- collection quests per fascicle: all prefixes, all suffixes, all words
  of a rarity (difficulty is never shown, ADR 0047; owner to decide);
- constellation laid out on two banks, no overlap by construction,
  bricks never move when a word arrives;
- ongoing investigations: paid hints stay visible until discovery.

Demos use only released fascicles (1 to 6), legendaries excluded. The
page also lists gaps verified in code, three of which reveal how many
legendaries a fascicle holds (last milestone threshold, legendary word
shown once its brick is found, codex numbering gaps).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0151stDRaZV3ScbhwvwjrfQ7
…situ

Owner review, second round:

- attempt memory: bricks already tried with the brick on the table are
  greyed and moved to the end of the reserve, recomputed whenever the
  table changes (failures, near misses and words already in the codex);
  the badges and the notebook variant are dropped;
- constellation: shown in situ inside the app shell from the mockups,
  as a codex view next to Tout, Récentes and Familles, on a phone and a
  desktop frame side by side; the module now mounts several instances;
- screenshots of the collection quests and the constellation, used by
  the App issues that hand both tracks over.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0151stDRaZV3ScbhwvwjrfQ7
…them up

ADR 0080 keeps bought hints readable as ongoing investigations, ADR 0081
remembers failed pairs until the next release (partly superseding the
"proposals are never stored" sentence of ADR 0027), ADR 0082 adds
per-fascicule collection quests by rarity, and ADR 0083 adds the
two-bank Réseau view of the codex. All four are proposed.

The index, ADR 0027 status, XREFS and adr.html follow; game-design.md
and the data model (new `essai` table) are aligned, and the hints
section now reflects ADR 0051. Mock-ups I-09 (reserve memory and
investigations) and I-12 (hints à la carte) are redrawn, I-35 (Réseau
view) is new, and the interface inventory lists it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0151stDRaZV3ScbhwvwjrfQ7
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants