Codex Game Studios v1.2.0

Codex Game Studios v1.2.0

v1.2.0 upgrades Spark Sprint from a static fixture to an optional runnable Godot example while keeping validation usable on Windows and macOS without Godot installed.

Highlights

• Added examples/spark-sprint/scenes/main.tscn.
• Added examples/spark-sprint/src/gameplay/main_scene.gd.
• Updated Spark Sprint scripts for movement, spark pickup, HUD updates, timer, win, timeout, and reset.
• Added tools/validate_godot_example.py; it reports SKIP when Godot is unavailable and loads the scene when Godot is found.
• Added Godot example validation to tools/run_all_validators.py.
• Bumped plugin metadata to 1.2.0.

Validation

Windows:

python tools\run_all_validators.py
python tools\validate_godot_example.py

macOS:

python3 tools/run_all_validators.py
python3 tools/validate_godot_example.py

If Godot is not installed, the Godot validator still passes after reporting SKIP.

Compatibility

• Existing cgs-* skill names remain stable.
• The plugin manifest path and marketplace path remain unchanged.
• Runtime hooks remain intentionally disabled.
• Godot is optional for repository validation and CI.

Codex Game Studios v1.1.0

Codex Game Studios v1.1.0

v1.1.0 hardens Windows and macOS usability for clone, validation, documentation, and fallback skill usage.

Highlights

• Added tools/run_all_validators.py as the single cross-platform validation entrypoint.
• Added tools/validate_cross_platform.py for Windows and macOS documentation and CI shape checks.
• Updated GitHub Actions to run validation on windows-latest, macos-latest, and ubuntu-latest.
• Added docs/platforms/windows.md, docs/platforms/macos.md, and docs/getting-started/first-run.md.
• Removed POSIX-only count checks from CI in favor of Python validators.
• Bumped plugin metadata to 1.1.0.

Validation

Windows:

python tools\run_all_validators.py

macOS:

python3 tools/run_all_validators.py

Release maintainers should also run:

python tools/migrate_from_claude.py
python tools/prepare_v01.py
python tools/run_all_validators.py

Compatibility

• Existing cgs-* skill names remain stable.
• The plugin manifest path and marketplace path remain unchanged.
• Runtime hooks remain intentionally disabled.
• Path-based skill invocation remains supported when plugin discovery is unavailable.

Codex Game Studios v1.0.0

Codex Game Studios v1.0.0

v1.0.0 freezes the core Codex Game Studios public interfaces and adds a CI-backed readiness checklist.

Highlights

• Added docs/v1-readiness/freeze-checklist.md.
• Added tools/validate_v1_readiness.py.
• Wired the v1 readiness validator into GitHub Actions.
• Updated README and AGENTS validation checklists.
• Bumped plugin metadata to 1.0.0.

Frozen Interfaces

• Existing cgs-* skill names remain stable.
• Plugin manifest path remains plugins/codex-game-studios/.codex-plugin/plugin.json.
• Marketplace path remains .agents/plugins/marketplace.json.
• Role cards remain reference prompts, not automatic subagents.
• Runtime hooks remain intentionally disabled.
• Validation stays explicit through scripts under tools/.

Validation

Run from the repository root:

python tools\migrate_from_claude.py
python tools\prepare_v01.py
python tools\validate_cgs.py
python tools\validate_skills.py
python tools\validate_smoke_fixture.py
python tools\validate_transcripts.py
python tools\validate_plugin_install_docs.py
python tools\validate_hook_policy.py
python tools\validate_examples.py
python tools\validate_workflow_polish.py
python tools\validate_v1_readiness.py
python tools\scan_legacy_tokens.py

Compatibility

Future v1.x releases may add docs, examples, validators, templates, role cards, or new skills. Breaking changes to existing skill names, manifest shape, marketplace path, or runtime hook policy require a new major version.

Codex Game Studios v0.9.0

Codex Game Studios v0.9.0

v0.9.0 records current local plugin discovery behavior and keeps the fallback path explicit for users whose Codex build does not expose repo-local plugin installation.

Highlights

• Added docs/install/field-test-2026-05-22.md.
• Documented success signs for repo-local plugin discovery.
• Documented fallback signs for direct SKILL.md path invocation.
• Added install problem reporting guidance.
• Extended tools/validate_plugin_install_docs.py to cover the field note.
• Bumped plugin metadata to 0.9.0.

Validation

Run from the repository root:

python tools\migrate_from_claude.py
python tools\prepare_v01.py
python tools\validate_cgs.py
python tools\validate_skills.py
python tools\validate_smoke_fixture.py
python tools\validate_transcripts.py
python tools\validate_plugin_install_docs.py
python tools\validate_hook_policy.py
python tools\validate_examples.py
python tools\validate_workflow_polish.py
python tools\scan_legacy_tokens.py

Compatibility

• No skill names changed.
• No marketplace path changed.
• No runtime hooks were added.
• Path-based skill invocation remains supported when plugin discovery is unavailable.

Codex Game Studios v0.8.0

Codex Game Studios v0.8.0

v0.8.0 adds a realistic Codex usage transcript for the Spark Sprint example.

Highlights

• Added docs/transcripts/spark-sprint-codex-run.md.
• Linked the transcript from docs/examples/spark-sprint.md and README.
• Extended transcript validation to cover the Spark Sprint run.
• Extended example validation to require the transcript link.
• Bumped plugin metadata to 0.8.0.

Validation

Run from the repository root:

python tools\migrate_from_claude.py
python tools\prepare_v01.py
python tools\validate_cgs.py
python tools\validate_skills.py
python tools\validate_smoke_fixture.py
python tools\validate_transcripts.py
python tools\validate_plugin_install_docs.py
python tools\validate_hook_policy.py
python tools\validate_examples.py
python tools\validate_workflow_polish.py
python tools\scan_legacy_tokens.py

Compatibility

• No skill names changed.
• No marketplace path changed.
• Runtime hooks remain intentionally disabled.
• The Spark Sprint example still validates without a local Godot installation.

Codex Game Studios v0.7.0

Codex Game Studios v0.7.0

v0.7.0 polishes the second batch of production workflows used around story readiness, scope control, evidence review, regression coverage, and release readiness.

Highlights

• Rewrote $cgs-story-readiness with clearer readiness rules and next-action routing.
• Rewrote $cgs-scope-check as a concise scope-drift review workflow.
• Rewrote $cgs-test-evidence-review as an acceptance-criteria-to-evidence review workflow.
• Rewrote $cgs-regression-suite around report, audit, and update modes.
• Rewrote $cgs-release-checklist around explicit release scope and go/no-go verdicts.
• Added docs/workflows/production-readiness-workflows.md.
• Added tools/validate_workflow_polish.py and wired it into CI.

Validation

Run these from the repository root:

python tools\migrate_from_claude.py
python tools\prepare_v01.py
python tools\validate_cgs.py
python tools\validate_skills.py
python tools\validate_smoke_fixture.py
python tools\validate_transcripts.py
python tools\validate_plugin_install_docs.py
python tools\validate_hook_policy.py
python tools\validate_examples.py
python tools\validate_workflow_polish.py
python tools\scan_legacy_tokens.py
python -m json.tool plugins\codex-game-studios\.codex-plugin\plugin.json
python -m json.tool .agents\plugins\marketplace.json

Roadmap Impact

This release closes #8 Polish second-batch production workflows for v0.7.

Codex Game Studios v0.6.0

Codex Game Studios v0.6.0

v0.6.0 adds a realistic, static example project that can exercise the Codex Game Studios workflow loop without requiring Godot to be installed.

Highlights

• Added examples/spark-sprint/, a Godot 4.3 / GDScript-style static example project.
• Included concept, systems, architecture, control manifest, epic, story, source drafts, test drafts, smoke checklist, and walkthrough.
• Added docs/examples/spark-sprint.md with the recommended prompt sequence.
• Added tools/validate_examples.py and wired it into GitHub Actions.
• Bumped regenerated plugin metadata to 0.6.0.

Validation

Run these from the repository root:

python tools\migrate_from_claude.py
python tools\prepare_v01.py
python tools\validate_cgs.py
python tools\validate_skills.py
python tools\validate_smoke_fixture.py
python tools\validate_transcripts.py
python tools\validate_plugin_install_docs.py
python tools\validate_hook_policy.py
python tools\validate_examples.py
python tools\scan_legacy_tokens.py
python -m json.tool plugins\codex-game-studios\.codex-plugin\plugin.json
python -m json.tool .agents\plugins\marketplace.json

Roadmap Impact

This release starts the v0.6-v1.0 track by adding the first realistic example project. Follow-up issues track second-batch workflow polish, install UX field notes, and v1 readiness.

Codex Game Studios v0.5.0

Codex Game Studios v0.5.0

v0.5.0 evaluates Codex runtime hook support and turns the project policy into a CI-backed check.

Highlights

• Added docs/hooks/runtime-hook-evaluation.md with the current hook decision, rationale, legacy hook mapping, and future adoption gate.
• Confirmed that Codex Game Studios does not bundle plugin runtime hooks in this release.
• Added tools/validate_hook_policy.py to enforce no hooks field in the plugin manifest and no plugin-root hooks/ directory.
• Wired hook policy validation into GitHub Actions.
• Bumped regenerated plugin metadata to 0.5.0.

Decision

Codex plugin hooks exist, but plugin-bundled hooks are off by default unless users enable [features].plugin_hooks = true. For this project template, safety checks should behave the same in a fresh clone and in CI. Therefore v0.5 keeps safety behavior explicit through scripts and skill instructions.

Validation

Run these from the repository root:

python tools\migrate_from_claude.py
python tools\prepare_v01.py
python tools\validate_cgs.py
python tools\validate_skills.py
python tools\validate_smoke_fixture.py
python tools\validate_transcripts.py
python tools\validate_plugin_install_docs.py
python tools\validate_hook_policy.py
python tools\scan_legacy_tokens.py
python -m json.tool plugins\codex-game-studios\.codex-plugin\plugin.json
python -m json.tool .agents\plugins\marketplace.json

Roadmap Impact

This release closes #5 Track Codex hook schema and evaluate runtime hook support with a documented decision: do not wire runtime hooks yet; keep explicit validators as the stable safety layer.

Codex Game Studios v0.4.0

Codex Game Studios v0.4.0

v0.4.0 focuses on local plugin installation UX. Codex builds may expose repo-local plugin installation differently, so this release documents both the preferred marketplace path and the reliable path-based fallback.

Highlights

• Added docs/install/local-plugin.md with the expected marketplace, plugin manifest, and skill paths.
• Documented verification prompts for $cgs-help, $cgs-project-stage-detect, and starter workflows.
• Documented fallback prompts that call SKILL.md files by path when local plugin installation is unavailable.
• Added troubleshooting checks for repo-root selection, JSON parsing, manifest paths, stale discovery, and runtime hook expectations.
• Added tools/validate_plugin_install_docs.py and wired it into CI.

Validation

Run these from the repository root:

python tools\migrate_from_claude.py
python tools\prepare_v01.py
python tools\validate_cgs.py
python tools\validate_skills.py
python tools\validate_smoke_fixture.py
python tools\validate_transcripts.py
python tools\validate_plugin_install_docs.py
python tools\scan_legacy_tokens.py
python -m json.tool plugins\codex-game-studios\.codex-plugin\plugin.json
python -m json.tool .agents\plugins\marketplace.json

Roadmap Impact

This release closes the initial documentation scope for #3 Document local plugin install UX and fallback paths.

The hook schema tracking issue remains open until Codex plugin runtime hook behavior is stable enough to wire safely.

Codex Game Studios v0.3.0

Codex Game Studios v0.3.0

v0.3.0 turns the validated v0.2 package into a clearer demo surface. The release focuses on the first real usage loop: starting from a small concept, shaping the project, picking up a story, and closing it with review and QA follow-up.

Highlights

• Added docs/transcripts/concept-to-story.md, a realistic transcript for Spark Sprint that walks through $cgs-start, $cgs-setup-engine, $cgs-map-systems, $cgs-create-architecture, $cgs-create-epics, $cgs-create-stories, $cgs-dev-story, and $cgs-story-done.
• Added docs/workflows/high-frequency-workflows.md to document the expected behavior of $cgs-code-review, $cgs-qa-plan, and $cgs-smoke-check.
• Tightened $cgs-code-review with severity rules and a findings-first output contract.
• Tightened $cgs-qa-plan with evidence rules and explicit test-matrix expectations.
• Tightened $cgs-smoke-check with a narrower smoke scope and clearer failure reporting.
• Added tools/validate_transcripts.py and wired it into CI.

Validation

Run these from the repository root:

python tools\migrate_from_claude.py
python tools\prepare_v01.py
python tools\validate_cgs.py
python tools\validate_skills.py
python tools\validate_smoke_fixture.py
python tools\validate_transcripts.py
python tools\scan_legacy_tokens.py
python -m json.tool plugins\codex-game-studios\.codex-plugin\plugin.json
python -m json.tool .agents\plugins\marketplace.json

Roadmap Impact

This release closes the initial implementation scope for:

• #1 Polish $cgs-code-review
• #2 Polish $cgs-qa-plan and $cgs-smoke-check
• #4 Add real project transcript for concept-to-story workflow

Follow-up work can continue by adding transcripts from real game projects and testing the local plugin install UX.