229c381c3e
* docs: import zacus conversation bundle v3 and close ZIP intake TODO * tools: add reproducible validator installer and document next gates * docs: remove ZIP terminology and align intake docs to conversation bundle * tools: add runtime bundle validator and update docs workflow * feat: promote gameplay scenario and enforce G3 bundle checks in CI * docs: add deep repo analysis and next-step TODOs * Initial plan (#107) Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
2.0 KiB
2.0 KiB
Zacus Conversation Bundle (v3)
Purpose
Bundle de travail conversationnel/IA conservé en dehors de la source canon gameplay (game/scenarios/*.yaml).
Files
scenario_promptable_template.yaml: template éditable (input prompt)scenario_canonical.yaml: YAML canonique conversation bundlescenario_runtime.json: JSON runtime dérivéfsm_mermaid.md: diagramme FSMCODEX_PROMPT.md: prompt Codex prêt à l'emploizacus_v2.yaml: narration MJ alignée bundleCONVERSATION_SUMMARY.md: synthèse des décisions
Validation workflow
- Installer les dépendances validateurs :
bash tools/setup/install_validators.sh
- Valider la cohérence interne du bundle :
python3 tools/scenario/validate_runtime_bundle.py
- Lancer les validateurs projet (non-régression canon/audio/printables) :
python3 tools/scenario/validate_scenario.py game/scenarios/zacus_v1.yamlpython3 tools/scenario/export_md.py game/scenarios/zacus_v1.yamlpython3 tools/audio/validate_manifest.py audio/manifests/zacus_v1_audio.yamlpython3 tools/printables/validate_manifest.py printables/manifests/zacus_v1_printables.yaml
Notes
- Ce bundle n'est pas promu automatiquement dans
game/scenarios/*.yaml. - Toute promotion doit passer par une revue fonctionnelle dédiée. Files:
- scenario_promptable_template.yaml : your editable template (prompt_input)
- scenario_canonical.yaml : canonical YAML (copy into docs/... target)
- scenario_runtime.json : runtime JSON (copy into data/story/scenarios/DEFAULT.json)
- fsm_mermaid.md : FSM diagram
- CODEX_PROMPT.md : ready-to-paste Codex prompt
- zacus_v2.yaml : narrative scenario aligned with runtime + gameplay reality
- CONVERSATION_SUMMARY.md : what changed / key decisions
Typical flow:
- Update prompt_input in scenario_promptable_template.yaml if needed.
- Use canonical/runtime files to update repo targets.
- Use zacus_v2.yaml as the printed narrative / MJ reference for the real game.
Generated: 2026-02-25