Files
codex-game-studio/.codex/workflows/patch-notes.md
T

2.6 KiB

model, model_reasoning_effort, primary-agent, linked-skills, phase, risk, argument-hint, source-reference, source-hash, output-artifacts
model model_reasoning_effort primary-agent linked-skills phase risk argument-hint source-reference source-hash output-artifacts
gpt-5.6-luna low release-manager
cgs-patch-notes
cgs-team-release
implement high Provide a patch notes request with release scope, fixes, known issues, validation evidence, audience, owner or handoff needs, and approval constraints. .codex/workflows/patch-notes.md abababababababababababababababababababababababababababababababab
plan
changed-files
verification-evidence
handoff

Patch Notes Workflow

Purpose

Draft patch notes with highlights, fixes, known issues, compatibility notes, validation evidence, and approval needs.

Inputs

  • AGENTS.md
  • .codex/studio.json
  • .codex/workflows/patch-notes.md
  • Release scope, changelog, bug fixes, known issues, and validation output

Role

Release Manager (release-manager) owns this workflow.

Taxonomy

Category: release-hotfix CCGS adaptation coverage:

  • patch notes
  • player-facing release communication CLI aliases:
  • patch-notes

Outputs

  • Player-facing patch notes.
  • Known issues and compatibility notes.
  • Approval, localization, and publishing checklist.

Validation

  • Notes do not overclaim unverified fixes.
  • Player-impact language is clear and accurate.
  • Known issues and rollback risks are visible.

Phase Gates

  • Confirm project state, owner role, write policy, and selected context.
  • Name required artifacts and acceptance criteria before implementation or review work.
  • Do not advance to handoff until evidence is recorded or a blocker is explicit.

Required Artifacts

  • Summary of the workflow result.
  • Files, assets, tasks, docs, release notes, or tests changed or proposed.
  • Verification evidence and unresolved risks.

Context Contract

  • Load AGENTS.md, .codex/studio.json, this workflow, the primary agent, linked skills, and only task-relevant project files.
  • Avoid broad context unless the user explicitly approves it.

Output Contract

  • Decision or change summary.
  • Step-by-step work performed or planned.
  • Evidence, blockers, warnings, and next owner.

Stop Conditions

  • Required project state, approval, target files, or verification path is missing.
  • The task crosses into another role without an explicit handoff.
  • The workflow would require generated prompt mirrors or hidden automation.

Handoff

Report changed files, validation evidence, residual risks, and the next owner only when ownership changes.

Document Target

  • Write the completed release record to docs/patch-notes.md.
  • Confirm the document is grounded in the release diff and validation evidence.