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.
This commit is contained in:
MerlinH
2026-06-26 00:31:03 +10:00
parent df25f80960
commit 87742e76d8
154 changed files with 5882 additions and 516 deletions
+16 -25
View File
@@ -1,35 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-14
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,VERSION
roles: gameplay-programmer,engine-programmer,tools-programmer,technical-artist
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Version Reference
version-applicability: Unity 2022 LTS and Unity 6 style projects unless project files state otherwise.
## Purpose
## Prefer
Use this file to confirm the reviewed engine version, official documentation root, and version-sensitive assumptions before making implementation claims.
- Use component-oriented scripts and keep serialized fields inspectable.
- Treat ProjectSettings and package manifest changes as reviewable engine changes.
## Guidance
## Avoid
- Match generated project engine version against this reviewed baseline.
- Prefer official docs for version-specific APIs.
- Record any project-local engine version drift in the handoff.
- Do not edit Library or other generated Unity cache folders.
- Do not assume package APIs without checking the manifest.
## Validation
## Pitfalls
- Scene and prefab YAML changes can be noisy and order-sensitive.
- Assembly definitions and packages can change compile boundaries.
## Verification Notes
- Run the configured Unity command or document an editor play-mode smoke check.
- Report scenes, prefabs, scripts, packages, and settings touched.
## Role Notes
- Programmers should distinguish runtime script changes from editor or package changes.
## Official Links
- https://docs.unity3d.com/Manual/index.html
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,breaking,changes
roles: gameplay-programmer,engine-programmer,qa-playtester,release-manager
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Breaking Changes
## Purpose
Surface version upgrade and compatibility risks before relying on engine behavior.
## Guidance
- Call out migration-sensitive APIs, package versions, serialization formats, and build settings.
- Separate confirmed breaking changes from speculative compatibility risks.
- Include rollback or compatibility notes for risky changes.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
@@ -0,0 +1,27 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,current,best,practices
roles: gameplay-programmer,engine-programmer,tools-programmer,technical-artist
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Current Best Practices
## Purpose
Apply current engine-native defaults without turning the task into broad process ceremony.
## Guidance
- Prefer engine-native composition and asset workflows.
- Keep edits scoped to the requested role/task.
- Mention scene, prefab, resource, project-setting, or asset-import changes explicitly.
- Use local validation evidence before claiming readiness.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
+26
View File
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,deprecated,apis
roles: gameplay-programmer,engine-programmer,qa-playtester,performance-analyst
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Deprecated APIs
## Purpose
Avoid stale APIs and migration traps when editing or reviewing engine code.
## Guidance
- Check version-specific deprecations before copying older snippets.
- Prefer supported APIs and document unavoidable legacy use.
- Treat deprecated APIs as warnings unless the task is a migration or compatibility fix.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
+18 -28
View File
@@ -1,36 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-14
source-link: https://docs.unity3d.com/Manual/CreatingAndUsingScripts.html
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,gameplay
roles: gameplay-programmer,engine-programmer,tools-programmer,technical-artist
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Gameplay Reference
# Unity Gameplay Implementation Reference
version-applicability: Unity gameplay scripts, scenes, prefabs, and play-mode checks.
## Purpose
## Prefer
Guide gameplay code with engine-native runtime patterns and verification evidence.
- Keep MonoBehaviour responsibilities small and visible through serialized fields.
- Use prefabs and scenes as explicit context when code depends on hierarchy.
## Guidance
## Avoid
- Keep gameplay state deterministic where practical.
- Separate authored content from generated/runtime data.
- Prefer small feature slices with direct playtest or automated validation.
- Avoid hidden scene-object lookup chains when dependencies can be assigned.
- Avoid editing generated project caches.
## Validation
## Pitfalls
- Script execution order and physics timestep can affect gameplay behavior.
- Prefab overrides may not be obvious from script diffs alone.
## Verification Notes
- Run available edit-mode or play-mode tests, or document a play-mode check.
- Name the scene or prefab used for manual verification.
## Role Notes
- Gameplay programmers receive this reference by default for Unity projects.
- Technical artists should cite material, shader, or prefab runtime impact.
## Official Links
- https://docs.unity3d.com/Manual/CreatingAndUsingScripts.html
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,animation,state-machine,blend,timeline
roles: gameplay-programmer,technical-artist,senior-game-artist,game-feel-designer
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Animation Module Reference
## Purpose
Animation graphs, timelines, clips, blending, events, and animation-state debugging.
## Guidance
- Select this file only for animation-related tasks.
- Keep implementation guidance scoped to Unity project files and validation commands.
- Include performance, accessibility, and content-pipeline risks when they apply.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
+26
View File
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,audio,sound,music,sfx
roles: audio-director,sound-designer,gameplay-programmer
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Audio Module Reference
## Purpose
Music, SFX, voice, routing, mixers, spatial audio, and subtitle/accessibility coordination.
## Guidance
- Select this file only for audio-related tasks.
- Keep implementation guidance scoped to Unity project files and validation commands.
- Include performance, accessibility, and content-pipeline risks when they apply.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
+26
View File
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,input,controls,accessibility,remap
roles: gameplay-programmer,ui-programmer,accessibility-specialist,game-feel-designer
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Input Module Reference
## Purpose
Input actions, rebinding, devices, accessibility, and control-scheme validation.
## Guidance
- Select this file only for input-related tasks.
- Keep implementation guidance scoped to Unity project files and validation commands.
- Include performance, accessibility, and content-pipeline risks when they apply.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,navigation,navmesh,pathfinding,ai
roles: ai-programmer,gameplay-programmer,level-designer
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Navigation Module Reference
## Purpose
Navigation meshes, pathfinding, AI agents, steering, and level-authoring constraints.
## Guidance
- Select this file only for navigation-related tasks.
- Keep implementation guidance scoped to Unity project files and validation commands.
- Include performance, accessibility, and content-pipeline risks when they apply.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,networking,multiplayer,replication,rollback
roles: network-programmer,gameplay-programmer,qa-playtester
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Networking Module Reference
## Purpose
Replication, rollback, authority, synchronization, server/client boundaries, and multiplayer test risk.
## Guidance
- Select this file only for networking-related tasks.
- Keep implementation guidance scoped to Unity project files and validation commands.
- Include performance, accessibility, and content-pipeline risks when they apply.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
+26
View File
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,physics,collision,simulation,game-feel
roles: gameplay-programmer,game-feel-designer,qa-playtester
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Physics Module Reference
## Purpose
Collision, rigid bodies, physics queries, deterministic simulation risks, and game-feel tuning.
## Guidance
- Select this file only for physics-related tasks.
- Keep implementation guidance scoped to Unity project files and validation commands.
- Include performance, accessibility, and content-pipeline risks when they apply.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,rendering,materials,lighting,performance
roles: technical-artist,engine-programmer,performance-analyst
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Rendering Module Reference
## Purpose
Materials, lighting, render pipelines, shaders, post-processing, and performance evidence.
## Guidance
- Select this file only for rendering-related tasks.
- Keep implementation guidance scoped to Unity project files and validation commands.
- Include performance, accessibility, and content-pipeline risks when they apply.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
+26
View File
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,ui,ux,hud,accessibility
roles: ui-programmer,ui-ux-designer,accessibility-specialist
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity UI Module Reference
## Purpose
HUDs, menus, widgets, focus, navigation, accessibility, and platform UI constraints.
## Guidance
- Select this file only for ui-related tasks.
- Keep implementation guidance scoped to Unity project files and validation commands.
- Include performance, accessibility, and content-pipeline risks when they apply.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
+18 -26
View File
@@ -1,34 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-14
source-link: https://docs.unity3d.com/Manual/Packages.html
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,plugins
roles: tools-programmer,engine-programmer,unity-specialist
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Package And Plugin Reference
# Unity Plugin And Package Reference
version-applicability: Unity package manifest, editor tooling, and plugin integrations.
## Purpose
## Prefer
Guide plugin/package use without adding hidden runtime dependencies.
- Keep package changes explicit in `Packages/manifest.json`.
- Separate editor-only code from runtime assemblies.
## Guidance
## Avoid
- Prefer package-manager or marketplace sources that are reviewable in the project.
- Record plugin version, install surface, and rollback risk.
- Avoid requiring plugins for lightweight prototypes unless explicitly justified.
- Avoid machine-local package paths unless the task explicitly requires them.
- Avoid broad editor automation that mutates unrelated assets.
## Validation
## Pitfalls
- Package resolution can differ across Unity versions.
- Editor scripts can run during import and produce unexpected asset changes.
## Verification Notes
- Report package manifest diffs and any editor menu or importer smoke check.
## Role Notes
- Tools programmers and engine programmers receive this when package or editor work is relevant.
## Official Links
- https://docs.unity3d.com/Manual/Packages.html
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,addressables,assets,content
roles: tools-programmer,engine-programmer,technical-artist,unity-specialist
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Unity Addressables Reference
## Purpose
Addressables asset loading, groups, labels, profiles, content updates, and runtime memory risk.
## Guidance
- Select this reference only when the task names or clearly implies Addressables.
- Identify package/plugin version, project files changed, and validation evidence.
- Avoid making this plugin mandatory for unrelated lightweight prototype work.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,cinemachine,camera,game-feel
roles: gameplay-programmer,technical-artist,game-feel-designer,unity-specialist
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Unity Cinemachine Reference
## Purpose
Camera rigs, follow/look-at targets, confiners, camera blending, and game-feel validation.
## Guidance
- Select this reference only when the task names or clearly implies Cinemachine.
- Identify package/plugin version, project files changed, and validation evidence.
- Avoid making this plugin mandatory for unrelated lightweight prototype work.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
+26
View File
@@ -0,0 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,dots,ecs,performance
roles: engine-programmer,performance-analyst,unity-specialist
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Unity DOTS Reference
## Purpose
Entities, Jobs, Burst, data-oriented design, and profiling gates for ECS-style work.
## Guidance
- Select this reference only when the task names or clearly implies DOTS.
- Identify package/plugin version, project files changed, and validation evidence.
- Avoid making this plugin mandatory for unrelated lightweight prototype work.
## Validation
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.
+17 -24
View File
@@ -1,33 +1,26 @@
reviewer: Open Game Studio seed review
date: 2026-06-14
date: 2026-06-17
source-link: https://docs.unity3d.com/Manual/index.html
engine: unity
version-reviewed: 6000.0
tags: unity,specialist
roles: unity-specialist
workflows: prototype,bugfix,architecture-review,qa-plan
# Unity Specialist Reference
# Unity Engine Specialist Reference
version-applicability: Unity specialist review and implementation across runtime and editor surfaces.
## Purpose
## Prefer
Guide the active engine specialist role with bounded, engine-specific review context.
- Anchor advice in scenes, prefabs, packages, assembly definitions, and ProjectSettings.
- Keep recommendations aligned with the active Unity version.
## Guidance
## Avoid
- Review engine idioms, project layout, version risks, plugins/packages, and validation commands.
- Do not load references for other engines.
- Escalate engine-version uncertainty instead of guessing.
- Avoid Unreal or Godot concepts unless the task is migration-oriented.
- Avoid loading all engine docs into general gameplay prompts.
## Validation
## Pitfalls
- YAML asset diffs can hide meaningful prefab or scene overrides.
## Verification Notes
- Name editor, play-mode, package, or build validation used.
## Role Notes
- `unity-specialist` should use this as the role-specific seed reference.
## Official Links
- https://docs.unity3d.com/Manual/index.html
- Prefer project-local engine commands and Open Game Studio project validation before readiness claims.
- Record unknown version-specific behavior as a risk instead of presenting it as confirmed.
- Keep this reference selected by relevance; do not load every engine reference for one task.