Scénarios en Gherkin standard validés par l'analyseur officiel ; ADR amendables

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

docs/scenarios/README.md

@@ -2,29 +2,41 @@
 
 La documentation utilisateur d'Ustagammon : un fichier par tâche réelle d'un
 joueur, écrit pour lui. Ces fichiers sont la seule source (ADR 0008) :
-l'application les affiche comme pages d'aide, et ils servent de tests de bout
-en bout.
+l'application les met en forme comme pages d'aide, et ils sont exécutés comme
+tests d'intégration sur le domaine et le moteur réel.
 
-Tant que l'outil d'exécution n'est pas choisi (avec le socle, fin de
-l'étape 0), les scénarios se déroulent à la main : ils servent alors de guide
-de test.
+Tant que le domaine n'existe pas, les scénarios se déroulent à la main : ils
+servent alors de guide de test.
 
 ## Format
 
-Markdown avec Gherkin (`.feature.md`), étapes en français :
+Gherkin standard (`.feature`), en français, validé par l'analyseur officiel de
+Cucumber (`make test`) :
 
-- `# Fonctionnalité : <la tâche>`, puis un court paragraphe qui explique à quoi
-  elle sert, pour le joueur ;
-- `## Scénario : <un cas précis>` ;
-- des étapes en liste : `* Étant donné …`, `* Quand …`, `* Et …`, `* Alors …`.
+```gherkin
+# language: fr
+Fonctionnalité: <la tâche>
 
-Règles d'écriture : la deuxième personne (« vous »), les mots du glossaire
-(`docs/glossaire/`), des étapes que le joueur peut faire et vérifier lui-même,
-pas de détail technique. La syntaxe exacte sera validée avec l'outil
-d'exécution.
+  Un court paragraphe qui explique au joueur à quoi elle sert.
+
+  Scénario: <un cas précis>
+    Étant donné que <la situation de départ>
+    Quand <ce que fait le joueur>
+    Alors <ce qu'il constate>
+    Et <autre constat>
+```
+
+Règles d'écriture :
+
+- la deuxième personne (« vous ») et les mots du glossaire (`docs/glossaire/`) ;
+- des intentions, pas des gestes d'interface : « vous commencez une nouvelle
+  partie », pas « vous touchez le bouton Nouvelle partie ». Le même scénario
+  reste vrai quelle que soit l'interface, et peut piloter directement le
+  domaine ;
+- des constats vérifiables par le joueur, sans détail technique.
 
 ## Scénarios
 
 | Fichier | Tâche | Depuis |
 | --- | --- | --- |
-| [jouer-une-partie.feature.md](jouer-une-partie.feature.md) | Jouer une partie contre l'ordinateur | Étape 0d |
+| [jouer-une-partie.feature](jouer-une-partie.feature) | Jouer une partie contre l'ordinateur | Étape 0d |