[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M751PESD4FQDYX6K5GW2ST23":3,"skill-same:01M751PESD4FQDYX6K5GW2ST23":89},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":50},"01M751PESD4FQDYX6K5GW2ST23","x-release",null,"Orchestrates complete release flow using Git Flow release branches with approval gate, PR-flow (gh CLI) and deep validation: version bump (auto-detect or explicit), release branch creation from develop, deep validation (coverage, golden files, version consistency), version file updates, changelog generation, release commit, release PR via gh (optionally reviewed by x-review-pr), human approval gate with persistent state file, tag on main after merged PR, back-merge PR to develop with conflict detection, and cleanup. Supports hotfix releases from main, dry-run mode, resume via --continue-after-merge, in-session pause via --interactive, GPG-signed tags, skip-review opt-out, and custom state file path.","review-bench\u002Federcnj_ia-dev-environment","review-bench","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F286778065?v=4","01M7517F9NTEPDZDAXJBR30FWT","ReviewBench","01M7517FAC9F4P7TGWCNJ8VYVW",0,"MIT","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: x-release\nmodel: sonnet\ndescription: \"Orchestrates complete release flow using Git Flow release branches with approval gate, PR-flow (gh CLI) and deep validation: version bump (auto-detect or explicit), release branch creation from develop, deep validation (coverage, golden files, version consistency), version file updates, changelog generation, release commit, release PR via gh (optionally reviewed by x-review-pr), human approval gate with persistent state file, tag on main after merged PR, back-merge PR to develop with conflict detection, and cleanup. Supports hotfix releases from main, dry-run mode, resume via --continue-after-merge, in-session pause via --interactive, GPG-signed tags, skip-review opt-out, and custom state file path.\"\nuser-invocable: true\nallowed-tools: Read, Write, Edit, Bash, Glob, Grep, Agent, Skill, AskUserQuestion, TaskCreate, TaskUpdate\nargument-hint: \"[major|minor|patch|version] [--version X.Y.Z] [--last-tag \u003Ctag>] [--dry-run] [--skip-tests] [--no-publish] [--no-github-release] [--hotfix] [--continue-after-merge] [--interactive] [--non-interactive] [--no-prompt] [--signed-tag] [--skip-review] [--ci-watch] [--state-file \u003Cpath>] [--skip-integrity] [--integrity-report \u003Cpath>] [--max-parallel \u003CN>] [--status] [--abort] [--yes] [--force]\"\nrequires-capabilities: []\n---\n\n## Global Output Policy\n\n- **Language**: English ONLY.\n- **Tone**: Technical, Direct, and Concise.\n- **Efficiency**: Remove all conversational fillers and greetings to save tokens.\n\n## Triggers\n\n```\n\u002Fx-release                     — auto-detect version bump from Conventional Commits\n\u002Fx-release major|minor|patch   — explicit bump type\n\u002Fx-release 2.1.0               — explicit version\n\u002Fx-release minor --dry-run     — preview plan without executing\n\u002Fx-release minor --dry-run --interactive  — interactive dry-run, pauses before each phase\n\u002Fx-release patch --hotfix      — hotfix release from main\n\u002Fx-release patch --skip-tests  — skip test validation\n\u002Fx-release --continue-after-merge  — resume after release PR manually merged\n\u002Fx-release --status            — show current release status (read-only)\n\u002Fx-release --abort             — abort active release with cleanup\n```\n\n## Parameters\n\n| Flag | Description |\n|------|-------------|\n| Bump type or `X.Y.Z` | `major`, `minor`, `patch`, or explicit version. Auto-detect from Conventional Commits if omitted (see `references\u002Fauto-version-detection.md`). `VERSION_NO_BUMP_SIGNAL` when no qualifying commits found. `VERSION_INVALID_FORMAT` when explicit version fails `^\\d+\\.\\d+\\.\\d+$`. |\n| `--dry-run` | Preview plan without executing any changes |\n| `--hotfix` | Create hotfix release from `main` instead of `develop` |\n| `--continue-after-merge` | Resume from `APPROVAL_PENDING` state after PR merged. Requires existing state file. |\n| `--interactive` | Opt-in to gate menus (PROCEED\u002FFIX-PR\u002FABORT) at Phase 8. With `--dry-run`: pauses before each phase. Default: non-interactive (Rule 20, EPIC-0061). |\n| `--non-interactive` | **DEPRECATED** — was CI opt-in; now equals default. Emits WARN. Removed in 2 releases. |\n| `--skip-review` | Skip `x-review-pr` fire-and-forget in OPEN-RELEASE-PR |\n| `--ci-watch` | Opt-in: poll CI on release PR via `x-watch-pr-ci`; abort on CI failure |\n| `--signed-tag` | Create GPG-signed tag (`git tag -s`) instead of annotated |\n| `--skip-tests` | Skip VALIDATE-DEEP test execution (warning emitted) |\n| `--no-publish` | Create release locally without pushing |\n| `--no-github-release` | Skip GitHub Release prompt in Phase 11 (CI path) |\n| `--state-file \u003Cpath>` | Override state file path (default: `ai\u002Freleases\u002Frelease-state-X.Y.Z.json`) |\n| `--abort [--yes]` | Abort active release: close PRs, delete branches, remove state file. `--yes` skips confirmations. |\n| `--status` | Show current release status read-only; exit 0 |\n\n**13-phase workflow:**\n\n```\n0. RESUME-DETECT → 1. DETERMINE → 1.5. PRE-FLIGHT → 2. VALIDATE-DEEP\n→ 3. BRANCH → 4. UPDATE → 5. CHANGELOG → 6. COMMIT → 7. OPEN-RELEASE-PR\n→ 7.5. CI-WATCH (opt-in) → 8. APPROVAL-GATE → 9. TAG → 10. BACK-MERGE-DEVELOP\n→ 11. PUBLISH → 12. CLEANUP → 13. SUMMARY\n```\n\n**Phase VALIDATE-DEEP (replaces Step 2):** 10 checks; advances state file `phase: VALIDATED`. `--skip-tests` skips checks 4, 5, 6; checks 1, 2, 3, 7, 8 are always-mandatory; check 9 conditional on `{{GENERATION_COMMAND}}` presence; check 10 bypassed with `--skip-integrity`.\n\n| # | Check | Command | Error Code |\n|---|-------|---------|-----------|\n| 1 | Working dir clean | `git status --porcelain` | `VALIDATE_DIRTY_WORKDIR` |\n| 2 | Correct base branch | `git branch --show-current` | `VALIDATE_WRONG_BRANCH` |\n| 3 | `[Unreleased]` CHANGELOG section non-empty | parse `CHANGELOG.md` | `VALIDATE_EMPTY_UNRELEASED` |\n| 4 | Build passes | `{{BUILD_COMMAND}}` | `VALIDATE_BUILD_FAILED` |\n| 5 | Coverage ≥ `{{COVERAGE_LINE_THRESHOLD}}`% line \u002F `{{COVERAGE_BRANCH_THRESHOLD}}`% branch | coverage report | `VALIDATE_COVERAGE_LINE` \u002F `VALIDATE_COVERAGE_BRANCH` |\n| 6 | Golden files current | `{{GOLDEN_TEST_COMMAND}}` | `VALIDATE_GOLDEN_DRIFT` |\n| 7 | No hardcoded version | `grep -r CURRENT_VERSION` | `VALIDATE_HARDCODED_VERSION` |\n| 8 | Cross-file version consistency | diff version files | `VALIDATE_VERSION_MISMATCH` |\n| 9 | Generation dry-run | `{{GENERATION_COMMAND}}` | `VALIDATE_GENERATION_DRIFT` |\n| 10 | Integrity drift | drift analysis | `INTEGRITY_DRIFT` |\n\n## Phase Workflow (Rule 25 — Task Hierarchy)\n\nThirteen phases (Rule 25 REGRA-001, EPIC-0055). Each numbered phase opens with a PRE gate + `TaskCreate`, closes with a POST\u002FFINAL gate + `TaskUpdate(completed)`. Phases 0, 1.5, 7.5 are exempted from gates (resume-detect, pre-flight, and optional CI-Watch). Full per-phase implementation in `references\u002Ffull-protocol.md`.\n\n\u003C!-- phase-no-gate: read-only state-file detection and arg normalization; no artifact produced -->\n## Phase 0 - Resume Detect\n\nOpen a phase tracker (close with `TaskUpdate(id: phase0TaskId, status: \"completed\")` after resume check):\n\n    TaskCreate(subject: \"RELEASE › Phase 0 - Resume Detect\", activeForm: \"Detecting release resume state\")\n\nCheck for existing `state.json` (`--state-file` override or default `ai\u002Freleases\u002Frelease-state-X.Y.Z.json`). If `--continue-after-merge`: load state, verify `phase == APPROVAL_PENDING`. Handle `--status` (read-only, exit 0) and `--abort`. See `references\u002Ffull-protocol.md §Phase 0`.\n\nPersist interactiveMode to release state (EPIC-0068 — consumed by Stop hook `enforce-continuous-flow.sh`):\n\n    Skill(skill: \"x-internal-update-status\", args: \"--file ai\u002Freleases\u002Frelease-state-{version}.json --type release --id \u003CVERSION> --field interactiveMode --value \u003Cinteractive|non-interactive>\")\n\nValue: `\"interactive\"` when `--interactive` passed or `CLAUDE_LEGACY_INTERACTIVE=1`; otherwise `\"non-interactive\"` (Rule 20 default, EPIC-0061).\n\n    TaskUpdate(id: phase0TaskId, status: \"completed\")\n\n## Phase 1 - Determine\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-1-Determine\")\n    TaskCreate(subject: \"RELEASE › Phase 1 - Determine\", activeForm: \"Determining release version\")\n\nDetect bump type from Conventional Commits (`feat:`→MINOR, `fix:`→PATCH, `!:`→MAJOR) or apply explicit argument. Validate `X.Y.Z` format. Emit `VERSION_NO_BUMP_SIGNAL` when no qualifying commits. Write initial `state.json` with `version`, `bumpType`, `phase: DETERMINED`. See `references\u002Fauto-version-detection.md`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-1-Determine --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase1TaskId, status: \"completed\")\n\n\u003C!-- phase-no-gate: pre-flight is a lightweight advisory check with no artifact output -->\n## Phase 1.5 - Pre-Flight\n\nOpen a phase tracker (close with `TaskUpdate(id: phase15TaskId, status: \"completed\")` after checks):\n\n    TaskCreate(subject: \"RELEASE › Phase 1.5 - Pre-Flight\", activeForm: \"Running pre-flight checks\")\n\nAdvisory checks: git remote reachable, no active release branch of same version, enough disk space for worktree. Warn on issues; do not abort. See `references\u002Ffull-protocol.md §Phase 1.5`.\n\n    TaskUpdate(id: phase15TaskId, status: \"completed\")\n\n## Phase 2 - Validate Deep\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-2-ValidateDeep\")\n    TaskCreate(subject: \"RELEASE › Phase 2 - Validate Deep\", activeForm: \"Running deep validation checks\")\n\nRun the 10-check VALIDATE-DEEP matrix (see table above). Advance state to `phase: VALIDATED`. Errors: `VALIDATE_DIRTY_WORKDIR`, `VALIDATE_BUILD_FAILED`, `VALIDATE_COVERAGE_LINE`, `VALIDATE_COVERAGE_BRANCH`, `VALIDATE_GOLDEN_DRIFT`, `VALIDATE_EMPTY_UNRELEASED`, `VALIDATE_HARDCODED_VERSION`, `VALIDATE_VERSION_MISMATCH`, `VALIDATE_GENERATION_DRIFT`, `INTEGRITY_DRIFT`. See `references\u002Ffull-protocol.md §Phase 2`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-2-ValidateDeep --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase2TaskId, status: \"completed\")\n\n## Phase 3 - Branch\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-3-Branch\")\n    TaskCreate(subject: \"RELEASE › Phase 3 - Branch\", activeForm: \"Creating release branch\")\n\nInvoke `x-create-git-branch` to create `release\u002FX.Y.Z` from `develop` (or `hotfix\u002FX.Y.Z` from `main` when `--hotfix`). Idempotent: no-op if branch already exists. Advance state to `phase: BRANCHED`. See `references\u002Ffull-protocol.md §Phase 3`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-3-Branch --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase3TaskId, status: \"completed\")\n\n## Phase 4 - Update\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-4-Update\")\n    TaskCreate(subject: \"RELEASE › Phase 4 - Update\", activeForm: \"Updating version files\")\n\nBump version in all version-bearing files (`pom.xml`, version constants, etc.) to `X.Y.Z`. Cross-validate all files agree. Advance state to `phase: UPDATED`. See `references\u002Ffull-protocol.md §Phase 4`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-4-Update --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase4TaskId, status: \"completed\")\n\n## Phase 5 - Changelog\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-5-Changelog\")\n    TaskCreate(subject: \"RELEASE › Phase 5 - Changelog\", activeForm: \"Generating changelog entry\")\n\nInvoke `x-generate-release-changelog` to promote `[Unreleased]` section to `[X.Y.Z] - DATE`. Advance state to `phase: CHANGELOG_UPDATED`. See `references\u002Ffull-protocol.md §Phase 5`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-5-Changelog --expected-artifacts CHANGELOG.md\")\n    TaskUpdate(id: phase5TaskId, status: \"completed\")\n\n## Phase 6 - Commit\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-6-Commit\")\n    TaskCreate(subject: \"RELEASE › Phase 6 - Commit\", activeForm: \"Committing release artifacts\")\n\nCommit version bumps + CHANGELOG via `x-commit-changes` with message `chore(release): X.Y.Z`. Push `release\u002FX.Y.Z` to origin. Advance state to `phase: COMMITTED`. See `references\u002Ffull-protocol.md §Phase 6`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-6-Commit --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase6TaskId, status: \"completed\")\n\n## Phase 7 - Open Release PR\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-7-OpenReleasePR\")\n    TaskCreate(subject: \"RELEASE › Phase 7 - Open Release PR\", activeForm: \"Opening release PR to main\")\n\nCreate PR `release\u002FX.Y.Z → main` via `gh pr create`. If `--skip-review` absent: fire `x-review-pr` in background (fire-and-forget). Advance state to `phase: PR_OPEN`. Record `prNumber` in state. See `references\u002Ffull-protocol.md §Phase 7`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-7-OpenReleasePR --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase7TaskId, status: \"completed\")\n\n\u003C!-- phase-no-gate: optional CI-watch poll loop; skipped unless --ci-watch flag present -->\n## Phase 7.5 - CI Watch\n\nOpen a phase tracker only when `--ci-watch` is set (close with `TaskUpdate` after poll completes):\n\n    TaskCreate(subject: \"RELEASE › Phase 7.5 - CI Watch\", activeForm: \"Polling CI on release PR\")\n\n**MANDATORY TOOL CALL — NON-NEGOTIABLE (Rule 24 + Rule 45):** Invoke the `x-watch-pr-ci` skill via the Skill tool on `prNumber`. On `CI_FAILED` (exit 20) or `TIMEOUT` (exit 30): abort release with corresponding error. On success (exit 0): advance to Phase 8. See `references\u002Ffull-protocol.md §Phase 7.5`.\n\n    Skill(skill: \"x-watch-pr-ci\", args: \"--pr-number {prNumber}\")\n\n    TaskUpdate(id: phase75TaskId, status: \"completed\")\n\n## Phase 8 - Approval Gate\n\n\u003C!-- TELEMETRY: phase.start -->\nBash command: `$CLAUDE_PROJECT_DIR\u002F.claude\u002Fhooks\u002Ftelemetry-phase.sh start x-release Phase-Approval-Gate`\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-8-ApprovalGate\")\n    TaskCreate(subject: \"RELEASE › Phase 8 - Approval Gate\", activeForm: \"Awaiting release approval\")\n\nPersist state with `phase: APPROVAL_PENDING`. Present EPIC-0043 gate menu (PROCEED \u002F FIX-PR \u002F ABORT) unless `--non-interactive`. On PROCEED: advance to Phase 9 (TAG). On FIX-PR: `Skill(skill: \"x-fix-pr\", args: \"\u003CprNumber>\")` then loop (max 3 cycles). See `references\u002Fapproval-gate-workflow.md`.\n\n\u003C!-- TELEMETRY: phase.end -->\nBash command: `$CLAUDE_PROJECT_DIR\u002F.claude\u002Fhooks\u002Ftelemetry-phase.sh end x-release Phase-Approval-Gate ok`\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-8-ApprovalGate --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase8TaskId, status: \"completed\")\n\n## Phase 9 - Tag\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-9-Tag\")\n    TaskCreate(subject: \"RELEASE › Phase 9 - Tag\", activeForm: \"Tagging release on main\")\n\nAfter PR merged: tag `main` HEAD as `vX.Y.Z` (annotated, or GPG-signed with `--signed-tag`). Push tag. Error: `TAG_EXISTS`. Advance state to `phase: TAGGED`. See `references\u002Ffull-protocol.md §Phase 9`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-9-Tag --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase9TaskId, status: \"completed\")\n\n## Phase 10 - Back Merge Develop\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-10-BackMerge\")\n    TaskCreate(subject: \"RELEASE › Phase 10 - Back Merge Develop\", activeForm: \"Back-merging release into develop\")\n\nCreate PR `release\u002FX.Y.Z → develop` via `gh pr create --auto-merge`. On conflict: emit `BACK_MERGE_CONFLICT`; see `references\u002Fbackmerge-strategies.md` for resolution flow. Advance state to `phase: BACK_MERGED`. See `references\u002Ffull-protocol.md §Phase 10`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-10-BackMerge --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase10TaskId, status: \"completed\")\n\n## Phase 11 - Publish\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-11-Publish\")\n    TaskCreate(subject: \"RELEASE › Phase 11 - Publish\", activeForm: \"Publishing GitHub release\")\n\nUnless `--no-github-release`: create GitHub Release via `gh release create vX.Y.Z --notes-from-tag`. Unless `--no-publish`: push any remaining artifacts. Advance state to `phase: PUBLISHED`. See `references\u002Ffull-protocol.md §Phase 11`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-11-Publish --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase11TaskId, status: \"completed\")\n\n## Phase 12 - Cleanup\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-12-Cleanup\")\n    TaskCreate(subject: \"RELEASE › Phase 12 - Cleanup\", activeForm: \"Cleaning up release branch\")\n\nDelete `release\u002FX.Y.Z` branch locally and on origin. Remove state file. Advance state to `phase: COMPLETED`. See `references\u002Ffull-protocol.md §Phase 12`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-12-Cleanup --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase12TaskId, status: \"completed\")\n\n## Phase 13 - Summary\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-13-Summary\")\n    TaskCreate(subject: \"RELEASE › Phase 13 - Summary\", activeForm: \"Generating release summary\")\n\nPrint Git Flow cycle explainer (see `references\u002Fgit-flow-cycle-explainer.md`). Emit final release summary: version, tag, PR numbers, durations. Advance state to `COMPLETED`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode final --skill x-release --phase Phase-13-Summary --expected-artifacts CHANGELOG.md\")\n    TaskUpdate(id: phase13TaskId, status: \"completed\")\n\n## Output Contract\n\n| Artifact | Path\u002FDescription |\n|----------|-----------------|\n| Release branch | `release\u002FX.Y.Z` (or `hotfix\u002FX.Y.Z` with `--hotfix`) |\n| Release PR | `release\u002FX.Y.Z → main`; URL in state file |\n| Back-merge PR | `release\u002FX.Y.Z → develop` via `BACK-MERGE-DEVELOP` phase; conflict-aware flow in `references\u002Fbackmerge-strategies.md` |\n| Git tag | `vX.Y.Z` on `main` HEAD after `RESUME-AND-TAG` via `OPEN-RELEASE-PR` → `APPROVAL-GATE` → `APPROVAL_PENDING` (annotated or GPG-signed) |\n| State file | `ai\u002Freleases\u002Frelease-state-X.Y.Z.json`; schema in `references\u002Fstate-file-schema.md`; initialized with `schemaVersion: 2` (`.schemaVersion != 2` emits `Expected: 2` error) |\n| CHANGELOG | Updated `CHANGELOG.md` via `x-generate-release-changelog` |\n\n## Error Envelope\n\n| Code | Condition |\n|------|-----------|\n| `VERSION_NOT_FOUND` | No previous tag found; cannot auto-detect |\n| `DIRTY_WORKDIR` | Uncommitted changes detected in VALIDATE-DEEP |\n| `COVERAGE_BELOW_THRESHOLD` | Line \u003C 95% or branch \u003C 90% in VALIDATE-DEEP |\n| `CHANGELOG_NOT_UPDATED` | `[Unreleased]` section empty in VALIDATE-DEEP |\n| `APPROVAL_GATE_ABORTED` | Operator selected ABORT in Phase 8 menu |\n| `CI_FAILED` | `--ci-watch` detected CI failure (exit 20) or timeout (exit 30) |\n| `BACK_MERGE_CONFLICT` | `develop` diverged from release branch; manual resolution required |\n| `TAG_EXISTS` | Git tag `vX.Y.Z` already present on remote |\n| `ABORT_NO_RELEASE` | `--abort` called but no state file exists |\n| `GATE_FIX_LOOP_EXCEEDED` | 3 consecutive FIX-PR cycles in Phase 8 without convergence |\n\n## Full Protocol\n\n> Complete per-phase implementation (Phases 0-13 with decision tables, bash commands, version-detection algorithm, VALIDATE-DEEP 10-check matrix, back-merge conflict-resolution flow, SUMMARY Git Flow cycle explainer) in [`references\u002Ffull-protocol.md`](references\u002Ffull-protocol.md). Additional references: [`approval-gate-workflow.md`](references\u002Fapproval-gate-workflow.md), [`auto-version-detection.md`](references\u002Fauto-version-detection.md), [`backmerge-strategies.md`](references\u002Fbackmerge-strategies.md), [`state-file-schema.md`](references\u002Fstate-file-schema.md), [`interactive-flow-walkthrough.md`](references\u002Finteractive-flow-walkthrough.md), [`prompt-flow.md`](references\u002Fprompt-flow.md), [`git-flow-cycle-explainer.md`](references\u002Fgit-flow-cycle-explainer.md).\n","## Global Output Policy\n\n- **Language**: English ONLY.\n- **Tone**: Technical, Direct, and Concise.\n- **Efficiency**: Remove all conversational fillers and greetings to save tokens.\n\n## Triggers\n\n```\n\u002Fx-release                     — auto-detect version bump from Conventional Commits\n\u002Fx-release major|minor|patch   — explicit bump type\n\u002Fx-release 2.1.0               — explicit version\n\u002Fx-release minor --dry-run     — preview plan without executing\n\u002Fx-release minor --dry-run --interactive  — interactive dry-run, pauses before each phase\n\u002Fx-release patch --hotfix      — hotfix release from main\n\u002Fx-release patch --skip-tests  — skip test validation\n\u002Fx-release --continue-after-merge  — resume after release PR manually merged\n\u002Fx-release --status            — show current release status (read-only)\n\u002Fx-release --abort             — abort active release with cleanup\n```\n\n## Parameters\n\n| Flag | Description |\n|------|-------------|\n| Bump type or `X.Y.Z` | `major`, `minor`, `patch`, or explicit version. Auto-detect from Conventional Commits if omitted (see `references\u002Fauto-version-detection.md`). `VERSION_NO_BUMP_SIGNAL` when no qualifying commits found. `VERSION_INVALID_FORMAT` when explicit version fails `^\\d+\\.\\d+\\.\\d+$`. |\n| `--dry-run` | Preview plan without executing any changes |\n| `--hotfix` | Create hotfix release from `main` instead of `develop` |\n| `--continue-after-merge` | Resume from `APPROVAL_PENDING` state after PR merged. Requires existing state file. |\n| `--interactive` | Opt-in to gate menus (PROCEED\u002FFIX-PR\u002FABORT) at Phase 8. With `--dry-run`: pauses before each phase. Default: non-interactive (Rule 20, EPIC-0061). |\n| `--non-interactive` | **DEPRECATED** — was CI opt-in; now equals default. Emits WARN. Removed in 2 releases. |\n| `--skip-review` | Skip `x-review-pr` fire-and-forget in OPEN-RELEASE-PR |\n| `--ci-watch` | Opt-in: poll CI on release PR via `x-watch-pr-ci`; abort on CI failure |\n| `--signed-tag` | Create GPG-signed tag (`git tag -s`) instead of annotated |\n| `--skip-tests` | Skip VALIDATE-DEEP test execution (warning emitted) |\n| `--no-publish` | Create release locally without pushing |\n| `--no-github-release` | Skip GitHub Release prompt in Phase 11 (CI path) |\n| `--state-file \u003Cpath>` | Override state file path (default: `ai\u002Freleases\u002Frelease-state-X.Y.Z.json`) |\n| `--abort [--yes]` | Abort active release: close PRs, delete branches, remove state file. `--yes` skips confirmations. |\n| `--status` | Show current release status read-only; exit 0 |\n\n**13-phase workflow:**\n\n```\n0. RESUME-DETECT → 1. DETERMINE → 1.5. PRE-FLIGHT → 2. VALIDATE-DEEP\n→ 3. BRANCH → 4. UPDATE → 5. CHANGELOG → 6. COMMIT → 7. OPEN-RELEASE-PR\n→ 7.5. CI-WATCH (opt-in) → 8. APPROVAL-GATE → 9. TAG → 10. BACK-MERGE-DEVELOP\n→ 11. PUBLISH → 12. CLEANUP → 13. SUMMARY\n```\n\n**Phase VALIDATE-DEEP (replaces Step 2):** 10 checks; advances state file `phase: VALIDATED`. `--skip-tests` skips checks 4, 5, 6; checks 1, 2, 3, 7, 8 are always-mandatory; check 9 conditional on `{{GENERATION_COMMAND}}` presence; check 10 bypassed with `--skip-integrity`.\n\n| # | Check | Command | Error Code |\n|---|-------|---------|-----------|\n| 1 | Working dir clean | `git status --porcelain` | `VALIDATE_DIRTY_WORKDIR` |\n| 2 | Correct base branch | `git branch --show-current` | `VALIDATE_WRONG_BRANCH` |\n| 3 | `[Unreleased]` CHANGELOG section non-empty | parse `CHANGELOG.md` | `VALIDATE_EMPTY_UNRELEASED` |\n| 4 | Build passes | `{{BUILD_COMMAND}}` | `VALIDATE_BUILD_FAILED` |\n| 5 | Coverage ≥ `{{COVERAGE_LINE_THRESHOLD}}`% line \u002F `{{COVERAGE_BRANCH_THRESHOLD}}`% branch | coverage report | `VALIDATE_COVERAGE_LINE` \u002F `VALIDATE_COVERAGE_BRANCH` |\n| 6 | Golden files current | `{{GOLDEN_TEST_COMMAND}}` | `VALIDATE_GOLDEN_DRIFT` |\n| 7 | No hardcoded version | `grep -r CURRENT_VERSION` | `VALIDATE_HARDCODED_VERSION` |\n| 8 | Cross-file version consistency | diff version files | `VALIDATE_VERSION_MISMATCH` |\n| 9 | Generation dry-run | `{{GENERATION_COMMAND}}` | `VALIDATE_GENERATION_DRIFT` |\n| 10 | Integrity drift | drift analysis | `INTEGRITY_DRIFT` |\n\n## Phase Workflow (Rule 25 — Task Hierarchy)\n\nThirteen phases (Rule 25 REGRA-001, EPIC-0055). Each numbered phase opens with a PRE gate + `TaskCreate`, closes with a POST\u002FFINAL gate + `TaskUpdate(completed)`. Phases 0, 1.5, 7.5 are exempted from gates (resume-detect, pre-flight, and optional CI-Watch). Full per-phase implementation in `references\u002Ffull-protocol.md`.\n\n\u003C!-- phase-no-gate: read-only state-file detection and arg normalization; no artifact produced -->\n## Phase 0 - Resume Detect\n\nOpen a phase tracker (close with `TaskUpdate(id: phase0TaskId, status: \"completed\")` after resume check):\n\n    TaskCreate(subject: \"RELEASE › Phase 0 - Resume Detect\", activeForm: \"Detecting release resume state\")\n\nCheck for existing `state.json` (`--state-file` override or default `ai\u002Freleases\u002Frelease-state-X.Y.Z.json`). If `--continue-after-merge`: load state, verify `phase == APPROVAL_PENDING`. Handle `--status` (read-only, exit 0) and `--abort`. See `references\u002Ffull-protocol.md §Phase 0`.\n\nPersist interactiveMode to release state (EPIC-0068 — consumed by Stop hook `enforce-continuous-flow.sh`):\n\n    Skill(skill: \"x-internal-update-status\", args: \"--file ai\u002Freleases\u002Frelease-state-{version}.json --type release --id \u003CVERSION> --field interactiveMode --value \u003Cinteractive|non-interactive>\")\n\nValue: `\"interactive\"` when `--interactive` passed or `CLAUDE_LEGACY_INTERACTIVE=1`; otherwise `\"non-interactive\"` (Rule 20 default, EPIC-0061).\n\n    TaskUpdate(id: phase0TaskId, status: \"completed\")\n\n## Phase 1 - Determine\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-1-Determine\")\n    TaskCreate(subject: \"RELEASE › Phase 1 - Determine\", activeForm: \"Determining release version\")\n\nDetect bump type from Conventional Commits (`feat:`→MINOR, `fix:`→PATCH, `!:`→MAJOR) or apply explicit argument. Validate `X.Y.Z` format. Emit `VERSION_NO_BUMP_SIGNAL` when no qualifying commits. Write initial `state.json` with `version`, `bumpType`, `phase: DETERMINED`. See `references\u002Fauto-version-detection.md`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-1-Determine --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase1TaskId, status: \"completed\")\n\n\u003C!-- phase-no-gate: pre-flight is a lightweight advisory check with no artifact output -->\n## Phase 1.5 - Pre-Flight\n\nOpen a phase tracker (close with `TaskUpdate(id: phase15TaskId, status: \"completed\")` after checks):\n\n    TaskCreate(subject: \"RELEASE › Phase 1.5 - Pre-Flight\", activeForm: \"Running pre-flight checks\")\n\nAdvisory checks: git remote reachable, no active release branch of same version, enough disk space for worktree. Warn on issues; do not abort. See `references\u002Ffull-protocol.md §Phase 1.5`.\n\n    TaskUpdate(id: phase15TaskId, status: \"completed\")\n\n## Phase 2 - Validate Deep\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-2-ValidateDeep\")\n    TaskCreate(subject: \"RELEASE › Phase 2 - Validate Deep\", activeForm: \"Running deep validation checks\")\n\nRun the 10-check VALIDATE-DEEP matrix (see table above). Advance state to `phase: VALIDATED`. Errors: `VALIDATE_DIRTY_WORKDIR`, `VALIDATE_BUILD_FAILED`, `VALIDATE_COVERAGE_LINE`, `VALIDATE_COVERAGE_BRANCH`, `VALIDATE_GOLDEN_DRIFT`, `VALIDATE_EMPTY_UNRELEASED`, `VALIDATE_HARDCODED_VERSION`, `VALIDATE_VERSION_MISMATCH`, `VALIDATE_GENERATION_DRIFT`, `INTEGRITY_DRIFT`. See `references\u002Ffull-protocol.md §Phase 2`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-2-ValidateDeep --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase2TaskId, status: \"completed\")\n\n## Phase 3 - Branch\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-3-Branch\")\n    TaskCreate(subject: \"RELEASE › Phase 3 - Branch\", activeForm: \"Creating release branch\")\n\nInvoke `x-create-git-branch` to create `release\u002FX.Y.Z` from `develop` (or `hotfix\u002FX.Y.Z` from `main` when `--hotfix`). Idempotent: no-op if branch already exists. Advance state to `phase: BRANCHED`. See `references\u002Ffull-protocol.md §Phase 3`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-3-Branch --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase3TaskId, status: \"completed\")\n\n## Phase 4 - Update\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-4-Update\")\n    TaskCreate(subject: \"RELEASE › Phase 4 - Update\", activeForm: \"Updating version files\")\n\nBump version in all version-bearing files (`pom.xml`, version constants, etc.) to `X.Y.Z`. Cross-validate all files agree. Advance state to `phase: UPDATED`. See `references\u002Ffull-protocol.md §Phase 4`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-4-Update --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase4TaskId, status: \"completed\")\n\n## Phase 5 - Changelog\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-5-Changelog\")\n    TaskCreate(subject: \"RELEASE › Phase 5 - Changelog\", activeForm: \"Generating changelog entry\")\n\nInvoke `x-generate-release-changelog` to promote `[Unreleased]` section to `[X.Y.Z] - DATE`. Advance state to `phase: CHANGELOG_UPDATED`. See `references\u002Ffull-protocol.md §Phase 5`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-5-Changelog --expected-artifacts CHANGELOG.md\")\n    TaskUpdate(id: phase5TaskId, status: \"completed\")\n\n## Phase 6 - Commit\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-6-Commit\")\n    TaskCreate(subject: \"RELEASE › Phase 6 - Commit\", activeForm: \"Committing release artifacts\")\n\nCommit version bumps + CHANGELOG via `x-commit-changes` with message `chore(release): X.Y.Z`. Push `release\u002FX.Y.Z` to origin. Advance state to `phase: COMMITTED`. See `references\u002Ffull-protocol.md §Phase 6`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-6-Commit --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase6TaskId, status: \"completed\")\n\n## Phase 7 - Open Release PR\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-7-OpenReleasePR\")\n    TaskCreate(subject: \"RELEASE › Phase 7 - Open Release PR\", activeForm: \"Opening release PR to main\")\n\nCreate PR `release\u002FX.Y.Z → main` via `gh pr create`. If `--skip-review` absent: fire `x-review-pr` in background (fire-and-forget). Advance state to `phase: PR_OPEN`. Record `prNumber` in state. See `references\u002Ffull-protocol.md §Phase 7`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-7-OpenReleasePR --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase7TaskId, status: \"completed\")\n\n\u003C!-- phase-no-gate: optional CI-watch poll loop; skipped unless --ci-watch flag present -->\n## Phase 7.5 - CI Watch\n\nOpen a phase tracker only when `--ci-watch` is set (close with `TaskUpdate` after poll completes):\n\n    TaskCreate(subject: \"RELEASE › Phase 7.5 - CI Watch\", activeForm: \"Polling CI on release PR\")\n\n**MANDATORY TOOL CALL — NON-NEGOTIABLE (Rule 24 + Rule 45):** Invoke the `x-watch-pr-ci` skill via the Skill tool on `prNumber`. On `CI_FAILED` (exit 20) or `TIMEOUT` (exit 30): abort release with corresponding error. On success (exit 0): advance to Phase 8. See `references\u002Ffull-protocol.md §Phase 7.5`.\n\n    Skill(skill: \"x-watch-pr-ci\", args: \"--pr-number {prNumber}\")\n\n    TaskUpdate(id: phase75TaskId, status: \"completed\")\n\n## Phase 8 - Approval Gate\n\n\u003C!-- TELEMETRY: phase.start -->\nBash command: `$CLAUDE_PROJECT_DIR\u002F.claude\u002Fhooks\u002Ftelemetry-phase.sh start x-release Phase-Approval-Gate`\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-8-ApprovalGate\")\n    TaskCreate(subject: \"RELEASE › Phase 8 - Approval Gate\", activeForm: \"Awaiting release approval\")\n\nPersist state with `phase: APPROVAL_PENDING`. Present EPIC-0043 gate menu (PROCEED \u002F FIX-PR \u002F ABORT) unless `--non-interactive`. On PROCEED: advance to Phase 9 (TAG). On FIX-PR: `Skill(skill: \"x-fix-pr\", args: \"\u003CprNumber>\")` then loop (max 3 cycles). See `references\u002Fapproval-gate-workflow.md`.\n\n\u003C!-- TELEMETRY: phase.end -->\nBash command: `$CLAUDE_PROJECT_DIR\u002F.claude\u002Fhooks\u002Ftelemetry-phase.sh end x-release Phase-Approval-Gate ok`\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-8-ApprovalGate --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase8TaskId, status: \"completed\")\n\n## Phase 9 - Tag\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-9-Tag\")\n    TaskCreate(subject: \"RELEASE › Phase 9 - Tag\", activeForm: \"Tagging release on main\")\n\nAfter PR merged: tag `main` HEAD as `vX.Y.Z` (annotated, or GPG-signed with `--signed-tag`). Push tag. Error: `TAG_EXISTS`. Advance state to `phase: TAGGED`. See `references\u002Ffull-protocol.md §Phase 9`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-9-Tag --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase9TaskId, status: \"completed\")\n\n## Phase 10 - Back Merge Develop\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-10-BackMerge\")\n    TaskCreate(subject: \"RELEASE › Phase 10 - Back Merge Develop\", activeForm: \"Back-merging release into develop\")\n\nCreate PR `release\u002FX.Y.Z → develop` via `gh pr create --auto-merge`. On conflict: emit `BACK_MERGE_CONFLICT`; see `references\u002Fbackmerge-strategies.md` for resolution flow. Advance state to `phase: BACK_MERGED`. See `references\u002Ffull-protocol.md §Phase 10`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-10-BackMerge --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase10TaskId, status: \"completed\")\n\n## Phase 11 - Publish\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-11-Publish\")\n    TaskCreate(subject: \"RELEASE › Phase 11 - Publish\", activeForm: \"Publishing GitHub release\")\n\nUnless `--no-github-release`: create GitHub Release via `gh release create vX.Y.Z --notes-from-tag`. Unless `--no-publish`: push any remaining artifacts. Advance state to `phase: PUBLISHED`. See `references\u002Ffull-protocol.md §Phase 11`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-11-Publish --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase11TaskId, status: \"completed\")\n\n## Phase 12 - Cleanup\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-12-Cleanup\")\n    TaskCreate(subject: \"RELEASE › Phase 12 - Cleanup\", activeForm: \"Cleaning up release branch\")\n\nDelete `release\u002FX.Y.Z` branch locally and on origin. Remove state file. Advance state to `phase: COMPLETED`. See `references\u002Ffull-protocol.md §Phase 12`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode post --skill x-release --phase Phase-12-Cleanup --expected-artifacts ai\u002Freleases\u002Frelease-state-{version}.json\")\n    TaskUpdate(id: phase12TaskId, status: \"completed\")\n\n## Phase 13 - Summary\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode pre --skill x-release --phase Phase-13-Summary\")\n    TaskCreate(subject: \"RELEASE › Phase 13 - Summary\", activeForm: \"Generating release summary\")\n\nPrint Git Flow cycle explainer (see `references\u002Fgit-flow-cycle-explainer.md`). Emit final release summary: version, tag, PR numbers, durations. Advance state to `COMPLETED`.\n\n    Skill(skill: \"x-internal-verify-phase-gates\", model: \"haiku\", args: \"--mode final --skill x-release --phase Phase-13-Summary --expected-artifacts CHANGELOG.md\")\n    TaskUpdate(id: phase13TaskId, status: \"completed\")\n\n## Output Contract\n\n| Artifact | Path\u002FDescription |\n|----------|-----------------|\n| Release branch | `release\u002FX.Y.Z` (or `hotfix\u002FX.Y.Z` with `--hotfix`) |\n| Release PR | `release\u002FX.Y.Z → main`; URL in state file |\n| Back-merge PR | `release\u002FX.Y.Z → develop` via `BACK-MERGE-DEVELOP` phase; conflict-aware flow in `references\u002Fbackmerge-strategies.md` |\n| Git tag | `vX.Y.Z` on `main` HEAD after `RESUME-AND-TAG` via `OPEN-RELEASE-PR` → `APPROVAL-GATE` → `APPROVAL_PENDING` (annotated or GPG-signed) |\n| State file | `ai\u002Freleases\u002Frelease-state-X.Y.Z.json`; schema in `references\u002Fstate-file-schema.md`; initialized with `schemaVersion: 2` (`.schemaVersion != 2` emits `Expected: 2` error) |\n| CHANGELOG | Updated `CHANGELOG.md` via `x-generate-release-changelog` |\n\n## Error Envelope\n\n| Code | Condition |\n|------|-----------|\n| `VERSION_NOT_FOUND` | No previous tag found; cannot auto-detect |\n| `DIRTY_WORKDIR` | Uncommitted changes detected in VALIDATE-DEEP |\n| `COVERAGE_BELOW_THRESHOLD` | Line \u003C 95% or branch \u003C 90% in VALIDATE-DEEP |\n| `CHANGELOG_NOT_UPDATED` | `[Unreleased]` section empty in VALIDATE-DEEP |\n| `APPROVAL_GATE_ABORTED` | Operator selected ABORT in Phase 8 menu |\n| `CI_FAILED` | `--ci-watch` detected CI failure (exit 20) or timeout (exit 30) |\n| `BACK_MERGE_CONFLICT` | `develop` diverged from release branch; manual resolution required |\n| `TAG_EXISTS` | Git tag `vX.Y.Z` already present on remote |\n| `ABORT_NO_RELEASE` | `--abort` called but no state file exists |\n| `GATE_FIX_LOOP_EXCEEDED` | 3 consecutive FIX-PR cycles in Phase 8 without convergence |\n\n## Full Protocol\n\n> Complete per-phase implementation (Phases 0-13 with decision tables, bash commands, version-detection algorithm, VALIDATE-DEEP 10-check matrix, back-merge conflict-resolution flow, SUMMARY Git Flow cycle explainer) in [`references\u002Ffull-protocol.md`](references\u002Ffull-protocol.md). Additional references: [`approval-gate-workflow.md`](references\u002Fapproval-gate-workflow.md), [`auto-version-detection.md`](references\u002Fauto-version-detection.md), [`backmerge-strategies.md`](references\u002Fbackmerge-strategies.md), [`state-file-schema.md`](references\u002Fstate-file-schema.md), [`interactive-flow-walkthrough.md`](references\u002Finteractive-flow-walkthrough.md), [`prompt-flow.md`](references\u002Fprompt-flow.md), [`git-flow-cycle-explainer.md`](references\u002Fgit-flow-cycle-explainer.md).\n",{"name":5,"model":24,"description":7,"allowed-tools":25,"argument-hint":26,"user-invocable":27,"requires-capabilities":28},"sonnet","Read, Write, Edit, Bash, Glob, Grep, Agent, Skill, AskUserQuestion, TaskCreate, TaskUpdate","[major|minor|patch|version] [--version X.Y.Z] [--last-tag \u003Ctag>] [--dry-run] [--skip-tests] [--no-publish] [--no-github-release] [--hotfix] [--continue-after-merge] [--interactive] [--non-interactive] [--no-prompt] [--signed-tag] [--skip-review] [--ci-watch] [--state-file \u003Cpath>] [--skip-integrity] [--integrity-report \u003Cpath>] [--max-parallel \u003CN>] [--status] [--abort] [--yes] [--force]",true,[],"main","952a630c6f38d193a349d86fa18db1de8843e837","src\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release",1,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment","https:\u002F\u002Fgithub.com\u002Freview-bench","https:\u002F\u002Freview-bench.ai","An open benchmark for AI code review.","2026-10-27 06:56:37",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":27},[40,43,46],{"tool":41,"command":42},"npx","npx skills add review-bench\u002Federcnj_ia-dev-environment --skill x-release",{"tool":44,"command":45},"bunx","bunx skills add review-bench\u002Federcnj_ia-dev-environment --skill x-release",{"tool":47,"command":48},"pnpm","pnpm dlx skills add review-bench\u002Federcnj_ia-dev-environment --skill x-release","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002FSKILL.md",[51,57,61,65,69,73,77,81,85],{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"README.md","REFERENCE","参考文档",2202,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002FREADME.md",{"path":58,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Fapproval-gate-workflow.md",12386,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002Freferences\u002Fapproval-gate-workflow.md",{"path":62,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fauto-version-detection.md",5640,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002Freferences\u002Fauto-version-detection.md",{"path":66,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Fbackmerge-strategies.md",5077,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002Freferences\u002Fbackmerge-strategies.md",{"path":70,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":71,"sourceHtmlUrl":72},"references\u002Ffull-protocol.md",16397,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002Freferences\u002Ffull-protocol.md",{"path":74,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Fgit-flow-cycle-explainer.md",3743,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002Freferences\u002Fgit-flow-cycle-explainer.md",{"path":78,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":79,"sourceHtmlUrl":80},"references\u002Finteractive-flow-walkthrough.md",21121,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002Freferences\u002Finteractive-flow-walkthrough.md",{"path":82,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":83,"sourceHtmlUrl":84},"references\u002Fprompt-flow.md",8297,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002Freferences\u002Fprompt-flow.md",{"path":86,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":87,"sourceHtmlUrl":88},"references\u002Fstate-file-schema.md",16111,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-release\u002Freferences\u002Fstate-file-schema.md",[90,97,104,111,118,125],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M757M8J48TQ1Y3X25GSJBXAS","x-parallel-eval","Detects and classifies file-collision risks between work units (tasks, stories, or epic phases) before parallel execution. Reads ## File Footprint blocks produced by x-task-plan \u002F x-story-plan, applies the parallelism-heuristics knowledge pack (hard \u002F regen \u002F soft categories + hotspot overrides), and emits a collision matrix + serialization recommendation in Markdown (default) or JSON.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fx-parallel-eval\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M757M57XMR9546S69466HDWT","parallelism-heuristics","Canonical catalog of file-collision heuristics for parallel task, story, and epic execution. Defines the File Footprint block format, the three Conflict Categories (hard \u002F regen \u002F soft), a hotspot list of high-contention paths, and the degrade-with-warning policy. Consumed by x-task-plan, x-story-plan, x-epic-map, x-parallel-eval, and x-dev-*-implement.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fparallelism-heuristics\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":19},"01M757M11SZ8P1VCQABT08QVYA","x-watch-pr-ci","Polls a PR's CI checks and Copilot review status, blocking until checks complete or timeout. Returns one of 8 stable exit codes (SUCCESS=0, CI_PENDING_PROCEED=10, CI_FAILED=20, TIMEOUT=30, PR_ALREADY_MERGED=40, NO_CI_CONFIGURED=50, PR_CLOSED=60, PR_NOT_FOUND=70). Writes a versioned state-file for session resume.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-watch-pr-ci\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":19},"01M757KW53K8KFPGADFB4PH949","x-validate-docs","Documentation freshness gate: validates 6 dimensions (readme, api-specs, grpc-proto, adr, skill-docs, system-architecture) against code changes in a PR. Stack-aware — only validates targets declared\u002Fauto-detected from ProjectConfig.documentation.targets. Returns exit non-zero on staleness; produces structured report.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-validate-docs\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":19},"01M757KQZHSA10MKC0CR571D60","x-update-system-architecture","Incrementally updates docs\u002Farchitecture\u002Fsystem.md after an epic completes. Appends new entries to the Decision Log (§11) using x-internal-write-report --append (dedup by ## ID: marker) and surgically inserts component\u002Fintegration changes into sections 1-10 via Edit. Idempotent: re-running with the same epic produces a byte-identical system.md.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-update-system-architecture\u002FSKILL.md",[],[],{"skillNo":126,"name":127,"nameZh":6,"description":128,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":129,"categories":130,"keywords":131,"publishedAt":19},"01M757KKBT5Q1SVF8DMJBVF46M","x-update-architecture","Incrementally updates the service architecture document with changes from architecture plans. Adds new components, integrations, flows, and ADR references without rewriting existing content. Use after implementation to keep architecture documentation current.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-update-architecture\u002FSKILL.md",[],[]]