golden-map-harness-workflow

name	golden-map-harness-workflow
description	Operational workflow for running golden-map fixture suites and reporting first deterministic divergence with actionable diagnostics.
tier	operational
godot_version	4.6+
doc_anchors	["godot-docs/tutorials/editor/command_line_tutorial.rst","godot-docs/tutorials/io/saving_games.rst","godot-docs/tutorials/scripting/debug/overview_of_debugging_tools.rst"]
tags	["validation","golden-map","workflow"]
depends_on	["godot-skills/godot-tertiary/golden-map-validation-harness-contract/SKILL.md","godot-skills/godot-operational/test-execution-contract/SKILL.md"]

Golden Map Harness Workflow

Use When

• Running deterministic fixture suites for board/path/LOS regressions.
• Verifying behavior after simulation or serialization changes.
• Triaging first divergence in rule-output stability.

Outcomes

• Fixture suite runs produce deterministic pass/fail reports.
• First mismatch is isolated with map/step/check context.
• Regression status is reproducible for local and CI runs.

Required Rules

• Execute fixtures in deterministic environment settings.
• Fail fast on first critical mismatch and preserve trace context.
• Keep fixture version and expected-output version explicit.
• Rebaseline fixtures only with approved migration rationale.

Workflow

1. Select fixture subset impacted by current change scope.
2. Run harness via scripted command and capture machine-readable output.
3. Stop on first critical mismatch and collect map/check diagnostics.
4. Re-run targeted fixture after fix before broad sweep.
5. Record results and note whether rebaseline is required.

Validation

• Same fixture run twice yields identical results and report ordering.
• Failure reports include first mismatch location and expected/actual delta.
• Rebaseline commits include migration justification and version note.

Failure Modes

• Harness runs with nondeterministic settings and causes flaky outcomes.
• Fixture updates are applied without explicit migration decision.
• Reports omit first divergence context, slowing debug loops.

Local Doc Anchors

• godot-docs/tutorials/editor/command_line_tutorial.rst
• godot-docs/tutorials/io/saving_games.rst
• godot-docs/tutorials/scripting/debug/overview_of_debugging_tools.rst