dialogic-draft

dialogic-draft

Two coexisting production models for Dialogic .dtl timelines:

• Scene model (primary) — recurring, multi-PNJ scenes (dîner, cellule, coursive…). Pipeline: scene-spec + pnj-behavior → write-scene.
• Node model (legacy) — linear scripted scenes (prologue, FIN codas, one-shot sequences). Pipeline: arc-spec → decompose → write-dtl.

fix applies to both models. No .dtl exits either pipeline without a linter PASS.

Available actions

#	Action	Role	Input	Model
01	scene-spec	Derive scene spec from overview + SCENE_ID	SCENE_ID + overview.md	Scene
02	pnj-behavior	Formalize PNJ behavioral profile (voice × palier × events)	PNJ name + bible-jeu.md	Scene
03	write-scene	Generate .dtl from scene-spec + pnj-behaviors, run linter	scenes/<ID>.md + pnjs-behavior/	Scene
04	arc-spec	Derive arc spec from overview + ARC_ID	ARC_ID + overview.md	Node
05	decompose	Break arc spec into node specs with Transitions table	arcs/<ARC_ID>.md	Node
06	write-dtl	Generate .dtl from node spec, run linter until PASS	nodes/<NN>.md	Node
07	fix	Rewrite targeted branch from review feedback, relint	.dtl path + feedback string	Both

Default flows

Scene model (primary): 01 → 02 → 03. Action 02 may be run independently for any PNJ. Action 07 re-enters after review.

Node model (legacy): 04 → 05 → 06. Action 07 re-enters after review.

Trigger-to-action mapping:

• "scene spec", "spec scène", "write scene spec" → scene-spec
• "pnj behavior", "fiche pnj", "pnj-behavior" → pnj-behavior
• "write scene", "generate scene", "écrire scène" → write-scene
• "arc spec", "spec arc", "write arc spec" → arc-spec
• "decompose arc", "break into nodes", "node decomposition" → decompose
• "write dtl", "generate timeline", "write node" → write-dtl
• "fix dtl", "apply feedback", "doctor", "write-scene --feedback" → fix

Dependency declarations

Scene model entry points (01-scene-spec, 02-pnj-behavior) have no ## Depends on. 03-write-scene depends on both. Node model entry point (04-arc-spec) has no ## Depends on. 05-decompose and 06-write-dtl declare ## Depends on. 07-fix has no ## Depends on (re-entry point).

Transversal rules

• No .dtl exits write-scene, write-dtl, or fix without linter PASS from scripts/tools/dtl_linter.gd (path: bank.yml § code.linter).
• Never invent variables — cross-check every flag, gauge, and faction against variables-register.md.
• No neutral subjects/branches — every choice must move at least one gauge or flag.
• Output of write-scene and write-dtl is .dtl only; no .tscn binaries, no .gd finals.
• fix rewrites only the targeted branch/subject; the rest of the .dtl is preserved verbatim.
• Scene model: scope of activatable gauges is declared in scene-spec — any signal outside scope → STOP.
• Scene model: PNJ presence must be resolved runtime (block at _ready), never hardcoded.
• Node model: arc-spec is source of truth for postconditions; node-spec is source of truth for transitions.

External data

• aidd_docs/memory/internal/bank.yml - canonical resource registry (lore, code, output styles, personas)
• aidd_docs/memory/external/overview.md - project overview consumed by scene-spec and arc-spec
• aidd_docs/memory/external/bible-jeu.md - narrative canon
• aidd_docs/memory/external/history.md - arc/node arborescence and endings
• aidd_docs/memory/external/pnjs-behavior/ - PNJ behavioral profiles (scene model)
• aidd_docs/memory/external/scenes/ - scene specs (scene model output)
• aidd_docs/memory/external/arcs/ - arc specs (node model)
• aidd_docs/memory/external/nodes/ - node specs (node model)
• aidd_docs/memory/internal/architecture.md - NODE format and Godot conventions
• aidd_docs/memory/internal/api-cheatsheet.md - DialogicBridge signal API
• aidd_docs/memory/internal/variables-register.md - flags, factions, countdowns, gauges
• aidd_docs/memory/internal/templates/scene-spec.md - scene spec output template (scene model)
• aidd_docs/memory/internal/templates/pnj-behavior.md - PNJ behavior output template (scene model)
• aidd_docs/memory/internal/templates/node-spec.md - node spec output template (node model)
• aidd_docs/memory/internal/templates/output-styles/scenario.md - default prose style
• scripts/tools/dtl_linter.gd - mechanical linter (mandatory gate)