Files
Ustagammon/PROMPTS.md
T
2026-11-02 12:56:36 +01:00

4.2 KiB

Prompts à coller dans Claude Code

À utiliser dans l'ordre, une session à la fois. Attendre que chaque sous-étape soit terminée et vérifiée (vous lancez vous-même la commande de démo) avant de passer à la suivante.


Prompt 1 — Démarrage et étape 0a

Bonjour. Lis CLAUDE.md, docs/cadrage.md et docs/etape-0.md avant toute chose.

Nous démarrons l'étape 0a : le moteur GNU Backgammon interrogeable en ligne de commande.

Avant de coder :
1. Résume en 10 lignes maximum ce que tu as compris du projet et des contraintes de ma machine.
2. Examine les trois sources possibles du moteur (gnubg, gnubg-nn, le dépôt CBG) et propose
   celle à utiliser, avec tes raisons. Attends ma validation.

Ensuite :
3. Mets en place le squelette du dépôt : Makefile (setup, build, test, lint, clean, help),
   LICENSE GPLv3, CREDITS.md, docs/journal.md, docs/decisions.md, .gitignore.
4. Crée l'image Docker de référence avec GNU Backgammon de bureau, et génère au moins
   30 positions de référence dans tests/reference/.
5. Écris l'interface C minimale du moteur et le programme engine-cli (sortie JSON).
6. Fais passer make test.

Travaille par petites étapes, fais un commit à chaque étape réussie, et termine par la
commande exacte que je dois lancer pour vérifier moi-même.

Prompt 2 — Étape 0b, le test WebAssembly

Relis docs/etape-0.md, section 0b, et docs/journal.md.

Objectif : compiler le même moteur en WebAssembly et mesurer s'il est assez rapide sur mon
Fairphone 4.

1. Ajoute une image Docker Emscripten et une cible make engine-wasm.
2. Crée dans web/ une page minimale : moteur chargé dans un Web Worker, saisie d'une
   position et des dés, affichage du meilleur coup et du temps de calcul.
3. Ajoute un test qui rejoue les positions de référence via le build WebAssembly
   (avec Node ou un navigateur sans interface) et vérifie qu'elles concordent avec 0a.
4. Ajoute make deploy-web pour servir la page sur mon réseau local, et affiche l'adresse
   à ouvrir depuis mon téléphone.
5. Ajoute une page ou une cible make bench qui mesure : temps par coup selon le niveau
   d'évaluation, taille téléchargée, mémoire.

Quand c'est prêt, dis-moi exactement quoi ouvrir sur le téléphone et quelles mesures
te rapporter.

Prompt 3 — Bilan des mesures et décision

Voici les mesures relevées sur mon Fairphone 4 :
[collez ici les résultats de la page de mesure]

Compare-les aux seuils de docs/etape-0.md. Recommande un socle (PWA ou Android natif)
avec tes raisons, les risques restants et ce que chaque option implique pour la suite.
Consigne la décision dans docs/decisions.md une fois que je l'ai validée.

Prompt 4a — Si la PWA est retenue : plateau minimal

Le socle retenu est la PWA. Passe à l'étape 0d.

Crée dans web/ un plateau minimal jouable : une partie complète contre le moteur,
coups et videau décidés par le moteur, dés tirés par l'app, saisie de mes coups au toucher.
Pas encore de design soigné : l'objectif est de valider la boucle de jeu complète.
Ajoute les tests de la boucle de jeu, rends l'app installable et utilisable hors ligne
(manifeste et service worker), et vérifie le tout avec make test et make deploy-web.

Prompt 4b — Si Android natif est retenu : étape 0c puis plateau

Le socle retenu est Android natif. Fais l'étape 0c puis 0d de docs/etape-0.md.

Rappel des contraintes : pas d'Android Studio, pas d'émulateur, build en ligne de commande
dans Docker, Gradle limité (-j2, mémoire du démon réduite). Installation sur mon Fairphone
par make deploy (adb). Appuie-toi sur la configuration NDK du dépôt CBG.
Termine par un plateau minimal jouable, sans design soigné.

Prompt de reprise (début de chaque nouvelle session)

Relis CLAUDE.md, docs/journal.md et docs/decisions.md. Résume en 5 lignes où nous en
sommes et propose la prochaine petite étape. Attends ma validation avant de coder.

Prompt de fin de session

Nous arrêtons pour aujourd'hui. Vérifie que make lint et make test passent, fais un commit,
et ajoute une entrée datée dans docs/journal.md : ce qui a été fait, décidé, et la prochaine
étape. Ne pousse pas sur le dépôt distant.