# Workflows

0. **Installer les validateurs** avec `bash tools/setup/install_validators.sh` (installe les dépendances Python requises, ex: PyYAML).
1. **Mettre à jour le YAML canon** (`game/scenarios/zacus_v2.yaml` ou nouvel ID). Les acts/stations/puzzles sont la source des prompts audio et printables.
2. **Valider le scénario** avec `tools/scenario/validate_scenario.py` pour garantir structure V2 (duration/acts/steps_narrative) et cohérence runtime.
3. **Exporter les briefings Markdown** via `tools/scenario/export_md.py` pour mettre à jour `kit-maitre-du-jeu/_generated/` et `docs/_generated/SCENARIO_BRIEF.md`.
4. **Valider l’audio** avec `tools/audio/validate_manifest.py audio/manifests/zacus_v2_audio.yaml` afin que chaque piste corresponde à un fichier de `game/prompts/audio/`.
5. **Valider les printables** avec `tools/printables/validate_manifest.py printables/manifests/zacus_v2_printables.yaml` pour s’assurer que chaque ID a un prompt accessible.

6. **Valider le conversation bundle** avec `tools/scenario/validate_runtime_bundle.py` pour vérifier la cohérence `scenario_runtime.json` / `scenario_canonical.yaml` / `scenario_promptable_template.yaml`.

7. **Générer le diff fonctionnel gameplay** avec `tools/scenario/diff_gameplay_scenarios.py` pour produire un rapport markdown dans `artifacts/qa-test/<date>/`.
