# Release

> Guide through the Cortex TMS release process — version bump, changelog, sync, tag, publish. Every step requires user approval.

- Skill: `cortex-tms/release` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cortex-tms/release`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cortex-tms/release/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cortex-tms (https://skillmd.com/u/cortex-tms)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cortex-tms/release

---


# 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