Files
codex-game-studio/docs/workflow-validation.md
T
MerlinH 87742e76d8 feat: expand Open Game Studio Codex depth
Add OpenSpec-backed catch-up passes for role coverage, workflow catalog, engine references, production templates, role prompt depth, behavioral validation, and project-local customization.

Ship expanded Codex-native scaffolding, role/workflow/template registries, engine reference assets, deterministic validation scenarios, customization pack support, routed Truthmark docs, OpenSpec artifacts, and regression coverage.
2026-06-26 00:31:03 +10:00

1.8 KiB

Workflow Validation

Validation exits nonzero when any check fails.

Repo validation checks package scripts, build output, package assets, engine configs, expanded role rendering, canonical workflow rendering, deterministic behavioral-evaluation scenarios, templates, package packing, installed-bin asset loading, future-only CLI surfaces, and Codex CLI readiness.

Project validation checks .codex/studio.json full roles, mode-specific activeRoles, registry-derived workflows, .codex/studio/config.json customization packs, AGENTS.md, generated project-specific role prompts, workflow files, engine source files, starter docs, timeline sections, forbidden legacy artifacts, and read-only status/resume behavior.

CLI surface checks:

npm exec opengamestudio -- run --help | grep -- "--dry-run"
! npm exec opengamestudio -- --help | grep -E " next|telemetry"

Workflow shortcut commands such as market, analytics, design-spec, feel-review, art-direction, ui-review, milestone, and handoff render prompts only. They do not launch Codex or create run records.

Behavioral evaluation scenarios are local deterministic validation subchecks. They render built-in role and workflow prompts, assert required prompt obligations, selected context categories, relevant templates, output-contract coverage, and forbidden future-only drift. They do not call hosted evaluators, telemetry, hidden memory, or LLM judges.

Project-local customization uses .codex/studio/config.json as an extend-only overlay. Custom role, workflow, and template IDs must use custom-*, must not override built-ins, and all referenced prompt/context/template paths must remain inside the project root.

No generated CODEX.md, .gamestudio/runs, or project_orchestrator.md is required or produced.