Cadrage et règles du projet

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

PROMPTS.md

@@ -0,0 +1,108 @@
+# 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
+
+```text
+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
+
+```text
+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
+
+```text
+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
+
+```text
+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
+
+```text
+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)
+
+```text
+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
+
+```text
+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.
+```