Compétences d'Engagement et de Rétention dans les Jeux
Un plugin Claude Code de trois compétences routées pour les moments de récompense en session et la rétention dans le cycle de vie des jeux et applications interactives grand public — la scène, la cohorte et le lien entre elles.
L'ensemble distingue les deux problèmes que les conseils génériques confondent en un seul — le moment (une interaction unique au sein d'une session) et le cycle de vie (une cohorte qui revient sur des jours et des semaines) — achemine chaque requête vers la compétence qui possède le livrable, et répond dans un format de carte fixe où chaque proposition comporte un déclencheur concret, une métrique pré-enregistrée avec sa baseline, des garde-fous incluant au moins une métrique de nuisance utilisateur, une catégorie d'effort, et — seulement lorsqu'il y a une limite à respecter ou un prix à nommer — une ligne d'éthique en langage clair.
Les jeux sont le cas profond ; cinq domaines interactifs grand public les accompagnent ; le SaaS est explicitement exclu. Voir Périmètre.
Installation — directement depuis ce dépôt, puis démarrez une nouvelle session :
/plugin marketplace add ajitta/Game-Engagement-Retention-Skills
/plugin install game-engagement-retention@game-engagement-retention-skills
Vérification, mises à jour, commandes slash et alternative sans plugin sous Installation.
Les trois compétences
| Compétence | Possède | Mode par défaut |
|---|---|---|
interaction-reward-moments (IRM) | La scène. Anticipation, révélation, choix, feedback, game feel, maîtrise, première victoire, clôture de fin de session, et l'accessibilité de tout effet sensoriel qu'elle prescrit. La durée de session est un diagnostic, jamais un objectif. | moments |
retention-strategy-designer (RSD) | Le cycle de vie et le calendrier. Événements de retour, cohortes, fenêtres de fuite, activation, habitude, attrition, résurrection, notifications, systèmes de cadence, LiveOps, rythme de méta-progression, sémantique des métriques, instrumentation, et le versant rétention de la monétisation. | strategy |
engagement-retention-advisor (ADV) | La jointure. Demandes à deux livrables, le lien moment-retour, le séquencement inter-couche, et un système nommé dont la valeur s'étend sur une session et un retour : guilde/clan, UGC, méta-progression, économie dans le jeu. | integrate |
Les fusionner produit "ajouter des récompenses et envoyer une notification". Les maintenir séparées force chacune à rester concrète, et le conseiller gagne sa place uniquement en connectant les couches plutôt qu'en concaténant deux listes.
Onze modes
Un mode est choisi avant que quoi que ce soit ne soit écrit, mais il n'est jamais imprimé : la ligne 1 de la réponse est une étiquette en langage clair du livrable dans la langue de sortie (Spécification de cadence — battle pass, 보상 순간 설계 — 강화 실패 구간), et le nom interne du mode n'apparaît jamais. --mode <name> sélectionne toujours le mode explicitement. Le mode décide quels modules de référence sont lus et quel artéfact est produit — ainsi, un tableau de cohortes collé donne une lecture de courbe au lieu de cinq propositions, et une demande de battle pass produit une fiche de spécification à remplir.
| Compétence | Mode | Se déclenche quand | Artéfact de sortie |
|---|---|---|---|
| IRM | moments | Une scène, boucle, révélation, choix ou sensation nommée est plate ; une plainte sur la durée de session | Tableau d'analyse + 3–5 cartes + séquence de mise en scène + notes de réglage transversales |
| IRM | first-win | Un beat de tutoriel, la première session, ou comment une session se termine | 1–3 cartes + chronologie de mise en scène avec timings + vérification d'accessibilité |
| RSD | strategy | Demande de cycle de vie ouverte : attrition, D1/D7/D30, cohortes, activation, résurrection, entonnoir FTUE | Tableau d'analyse + 3–5 cartes + ordonnancement + plan de mesure |
| RSD | read | Un nombre, une courbe, un tableau de cohortes ou une définition de métrique est lui-même l'objet | Vérification de définition + lecture de courbe + ≤2 hypothèses. Aucune carte de proposition |
| RSD | cadence | Un mécanisme nommé : pass, pile de quêtes, calendrier de connexion, streak, énergie, notification, reconquête | Fiche de spécification à deux colonnes + limites d'acceptation + drapeaux de relecture + un exemple rempli |
| RSD | calendar | Un plan daté sur plusieurs semaines : calendrier LiveOps, feuille de route saisonnière, rythme de méta-progression | Semaine / Beat / Type / Événement de retour / Métrique + 3 mini-cartes + vérification des collisions |
| RSD | economics | Compromis revenus vs rétention : ARPDAU/LTV vs D7, charge publicitaire, cadence des offres, paywall | Cadre LTV + un calcul de seuil de rentabilité + limites. ≤2 cartes |
| RSD | instrument | Plan de suivi, taxonomie d'événements, conception d'expérience | Événement / Se déclenche quand / Propriétés / Répond à + définitions d'événement de retour et de clé de cohorte |
| ADV | integrate | Deux livrables, ou le lien moment-retour lui-même | Tableau d'analyse + 3–5 cartes intégrées + une section de résidu explicite |
| ADV | compare | Choix de priorité, séquencement, priorisation, "devrions-nous le construire du tout" | Tableau d'options + ordre de mesure + au plus une carte |
| ADV | system | Un système nommé inter-couche | Fiche système + 2–3 cartes de sous-mécanisme + instrumentation |
Chaque mode nomme au plus trois modules de référence et n'en lit pas plus. Si un quatrième semble nécessaire, la requête couvre deux modes : la compétence choisit le primaire, y répond, et dit en une ligne ce qu'elle a différé.
Comment fonctionne le routage
Routez sur le livrable, pas sur la présence de mots-clés. Une métrique de rétention citée uniquement comme motivation ou comme critère de succès n'est pas une seconde demande. "D7 est faible, corrigez la révélation de récompense" est une correction de scène avec D7 comme cible de validation — pas une demande de rétention. Cette seule règle est ce qu'une règle de mot-clé ("contient D7 → compétence rétention") fait mal sur chaque requête où la rétention est l'objectif déclaré.
Lorsque le livrable est un artéfact nommé plutôt qu'une couche, il est routé par sa ligne ici, dans le mode nommé ici. Le tableau est identique dans les trois corps de compétence — une règle absente du fichier qui a déclenché n'existe pas pour cette exécution — et scripts/check-shared-blocks.sh fait échouer la build en cas de divergence entre les trois copies et le bloc canonique dans contracts.md.
| Livrable nommé | Compétence | Mode |
|---|---|---|
| Scène, sensation, révélation, choix, mise en scène, "pas amusant" en session | IRM | moments |
| Plainte sur la durée de session / abandon en cours de session | IRM | moments |
| Un beat de tutoriel nommé semble plat ; la première victoire n'atterrit pas | IRM | first-win |
| Beat de révélation de déverrouillage lui-même | IRM | moments |
| Accessibilité d'un effet sensoriel (flash, secousse, haptiques, mouvement) | IRM | moments |
| Attrition, D1/D7/D30, cohortes, activation, résurrection | RSD | strategy |
| Entonnoir de tutoriel/FTUE : quelle étape, ordre, gating, fuite D0→D1 | RSD | strategy |
| Courbe ou tableau de cohortes collé sans changement demandé | RSD | read |
| Définition de métrique de rétention ; glissante vs classique ; D28 vs D30 | RSD | read |
| Battle pass, saison, quêtes quotidiennes/hebdomadaires, calendrier de connexion, streak, énergie | RSD | cadence |
| Copie de notification / push | RSD | cadence |
| Calendrier LiveOps / d'événements, feuille de route saisonnière, plan sur 90 jours | RSD | calendar |
| Rythme de méta-progression entre les parties | RSD | calendar |
| ARPDAU/LTV vs rétention, charge publicitaire, cadence des offres, premier achat, paywall | RSD | economics |
| Taxonomie d'événements analytiques, plan de suivi, conception d'expérience | RSD | instrument |
| Deux livrables, ou le lien moment-retour lui-même | ADV | integrate |
| Plainte de moment associée à une plainte d'attrition | ADV | integrate |
| Comparer / séquencer / prioriser niveau moment vs niveau cycle de vie | ADV | compare |
| "Devrions-nous construire un tutoriel du tout" | ADV | compare |
| Guilde/clan, UGC & création-partage, économie dans le jeu, système de méta-progression | ADV | system |
| Conception de monétisation : tarification, eCPM, médiation, taux de gacha ou ajustement de pity | — | refuser en une ligne, nommer la limite |
| Activation ou attrition SaaS / B2B | — | refuser en une ligne, nommer le périmètre |
Deux règles de soutien : l'abandon du tutoriel est un symptôme d'entonnoir, pas un livrable — routez sur l'artéfact demandé. Et un transfert est un échec de routage que l'utilisateur paie deux fois, donc une compétence transfère au plus une fois par tour, jamais à la compétence qui lui a transféré, et autrement répond sur place sous ses propres garde-fous.
À quoi ressemble la sortie
Les tableaux analysent ; les cartes portent. Un tableau contient une étiquette courte, un nombre ou une date, et jamais plus de 5 colonnes. Tout ce que le lecteur doit lire — justification, éthique, mise en scène du feedback — va dans une puce de carte, une phrase chacune. Les puces d'exécution (mesure, garde-fous, éthique, effort) se trouvent à l'intérieur de la carte pour ne pas pouvoir être supprimées sous la pression de la longueur.
Exemple abrégé — une réponse réelle comporte 3 à 5 cartes, et le tableau d'analyse les liste toutes :
Conception de moment de récompense — roguelike descendante, choix d'amélioration après salle
| # | Nom | Se déclenche quand | Métrique clé |
|---|---|---|---|
| 1 | Troisième option télégraphiée | Salle terminée en tenant une paire taguée | Taux de complétion de paire taguée vs hasard |
| 2 | Paiement de survie de justesse | Salle terminée avec ≤15% de PV | Taux de ré-entrée dans la salle suivante |
| 3 | Aperçu de faiblesse d'élite | Carte d'amélioration résolue | Taux de prévisualisation à changement d'équipement |
### 1. Troisième option télégraphiée
**En une phrase** — La troisième carte est tirée des tags que la partie possède déjà, donc le choix est une décision de construction, pas un menu de stats.
- **Se déclenche quand** : la salle se termine et la partie possède ≥2 améliorations partageant un tag (évalué une fois, à la distribution des cartes)
- **Le joueur fait** : prend la carte de synergie maintenant, ou mise sur une carte autonome plus forte et garde la paire ouverte
- **Pourquoi ça marche** : compétence lue comme une croissance de capacité, plus une incertitude bornée que le joueur peut réellement raisonner
- **Feedback** : pulsation de tag correspondant sur les icônes possédées (2 pulsations max) → hit-stop de 120 ms sur la sélection → synergie résolue comme un nombre, pas un mot
- **Prochain accroche** : l'aperçu de carte nomme le tag auquel le prochain élite est faible
- **Mesure** : taux de complétion de paire taguée, contre le même taux mesuré sur la build actuelle *avant* le déploiement
- **Garde-fous** : distribution temporelle de décision reste multi-modale · pas de revente de reroll pour de la monnaie · fréquence des mots-clés de révision pour "forcé"
- **Effort** : S (client uniquement, constantes configurables à distance) · **Dépend de** : rien · **Tuer si** : la complétion de paire atterrit sous le hasard +5pp
Chaque réponse porte les mêmes sections fixes dans le même ordre : l'étiquette du livrable → hypothèses (au plus quatre lignes, uniquement les suppositions qui changeraient quelles propositions vous obtenez, chacune taguée) → le corps du mode → ordonnancement par impact par unité d'effort → plan de mesure → une section de reconception uniquement lorsqu'une limite légale ou de plateforme a réellement échoué → drapeaux de juridiction → base — une ligne dans les propres mots du concepteur nommant les vérifications qui ont été exécutées, et toute vérification qui n'a pas pu être exécutée. Cette dernière ligne est un dispositif de conformité, pas une décoration : une lecture obligatoire ignorée apparaît là comme une vérification qui n'a pas pu être exécutée, en langage clair et jamais comme un nom de fichier.
Deux règles que le format applique contre l'invention. L'effort est une catégorie (S ≤1 semaine / M 1–3 semaines / L >3 semaines ou nouvel art ou changement système) ; l'ordre de déploiement est énoncé, mais les semaines de déploiement, les effectifs et les coûts ne le sont jamais, car le modèle ne peut pas connaître votre calendrier. Et tout nombre que la compétence introduit porte [source | population | année | définition] en ligne, ou il n'est pas écrit.
Langue. Les réponses suivent la langue d'entrée. Coréen en → coréen out, avec des titres coréens ; jamais de titres bilingues, jamais de modèle qui se lit comme un formulaire rempli.
Éthique : quatre niveaux, pas une liste d'interdiction
Une liste d'interdiction plate interdit la conception légitime ordinaire de service en direct et ne bénit rien de mesurable. v2 la remplace par un modèle gradué où le refus ne se déclenche que sur T1 et T2a, et uniquement sur la puce défaillante — le reste de la conception est livré.
| Niveau | Signification | Réponse |
|---|---|---|
| T1 Illégal | Loi ou règle de magasin en vigueur dans un marché nommé | Refuser cette configuration, la reconcevoir, livrer le reste |
| T2a Plateforme | Violation de politique de magasin sans version conforme | Refuser cette configuration, la reconcevoir, livrer le reste |
| T2b Classification | Coûte une tranche d'âge ou une classification | Prix du choix — une ligne plus la variante qui l'évite ; refuser uniquement contre une cible de classification que vous avez énoncée |
| T3 Préjudice | Preuve publiée de préjudice utilisateur | Ne jamais refuser. Livrer contre un cahier des charges conforme numérique plus une métrique de signal de défaillance |
| T4 Préférence | Efficacité contestée ; position de l'auteur | Ne jamais refuser. Livrer les deux options, marquer la position en une clause |
Trois questions ordonnées sont exécutées pendant la génération, pas comme un filtre après : le public inclut-il des mineurs (la superposition s'applique avant la recherche de ligne, et peut déplacer un mécanisme de deux niveaux) ; de quelle famille de mécanisme s'agit-il et que dit sa ligne ; cette configuration répond-elle au cahier des charges conforme point par point. Un mécanisme qui n'est pas une ligne n'est pas un cas de refus — la compétence continue et n'émet rien sur la ligne absente. Un mécanisme entièrement conforme n'émet aucune puce d'éthique du tout — pas de code de niveau, pas d'identifiant de famille, et pas de ligne disant qu'il n'y avait rien à signaler ; il n'y a aucun chemin par lequel une conception conforme produit du texte.
Chaque mécanisme auparavant interdit est reclassé avec une spécification au lieu d'une interdiction. Énergie et endurance, gel de streak payé, streaks d'apprentissage, boucles d'obligation sociale et 기다리면 무료 sont tous livrés avec des limites numériques — scripts/check-ethics-rows.sh fait échouer la build si une ligne T3 manque d'une spécification conforme numérique ou observable, ce qui rend "l'énergie est interdite" littéralement inscriptible. Les cotes cachées sur les objets aléatoires payants restent T1 contre des instruments nommés et datés ; les adieux de compagnon IA cadrés par la culpabilité conservent leur interdiction car aucune configuration conforme n'existe. Les affirmations légales sont isolées dans jurisdictions.md avec un en-tête last-verified et une liste ## Ne pas citer des lois plausibles qui n'existent pas.
Cinq gardes de faux positifs maintiennent l'autre
…
[truncated for translation]