---
name: Release
slug: release-8
category: DevOps
description: Release guides a Cortex TMS version bump, changelog update, tag, publish, and GitHub release. It runs the required quality gate first and pauses for user approval at every step.
github: "https://github.com/cortex-tms/cortex-tms/tree/main/.claude/skills/release"
language: MDX
stars: 181
forks: 7
install: "npx degit https://github.com/cortex-tms/cortex-tms/tree/main/.claude/skills/release ~/.claude/skills/release"
installs_to: ~/.claude/skills/release
source_path: .claude/skills/release/SKILL.md
collection_size: 6
category_size: 1044
collection_url: "https://dirskills.com/collections/cortex-tms/cortex-tms"
added: 2026-09-07T05:20:18.084Z
last_synced: 2026-09-07T05:20:18.084Z
canonical_url: "https://dirskills.com/skills/release-8"
---

# Release

Release guides a Cortex TMS version bump, changelog update, tag, publish, and GitHub release. It runs the required quality gate first and pauses for user approval at every step.

**Install:**

```bash
npx degit https://github.com/cortex-tms/cortex-tms/tree/main/.claude/skills/release ~/.claude/skills/release
```

## README

# Release

Guide the user through a Cortex TMS release.

## Pre-release Gate

Before starting, run the full quality gate:
1. `pnpm test` — must pass
2. `pnpm run lint` — must have 0 errors
3. `pnpm run build` — must succeed
4. `node bin/cortex-tms.js validate --strict` — must pass

If any step fails, STOP and report. Do not proceed with a broken release.

## Release Steps (each requires user approval)

1. **Bump version** — show the new version number and the command. Wait for approval.
   ```bash
   npm version [patch|minor|major]
   ```

2. **Sync version tags** — update all version markers across docs.
   ```bash
   node scripts/sync-project.js
   ```

3. **Update CHANGELOG.md** — draft release notes from commits since last tag. Show draft, wait for approval.

4. **Commit release** — show commit message, wait for approval.

5. **Create git tag** — show tag command, wait for approval.
   ```bash
   git tag v[version]
   ```

6. **Push** — show push command, wait for approval.
   ```bash
   git push origin main --tags
   ```

7. **Publish to NPM** — show publish command, wait for approval.
   ```bash
   npm publish
   ```

8. **Create GitHub release** — draft release notes, wait for approval.

## Rules

- NEVER skip a step
- NEVER proceed without explicit user approval at each gate
- If something fails mid-release, stop and explain how to recover

## Arguments

$ARGUMENTS