> ## Documentation Index
> Fetch the complete documentation index at: https://meganharrisonconsulting.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# release

> Release vercel-plugin — run gates, bump version, generate artifacts, commit, and push. Use when asked to "release", "ship", "bump and push", or "cut a release".

This page is generated from the actual `SKILL.md` file on disk.

## Metadata

| Field               | Value                                                                                                                                                            |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Source group        | Plugin Skills                                                                                                                                                    |
| Source root         | `/Users/meganharrison/.codex/plugins/cache`                                                                                                                      |
| Relative skill path | `vercel/vercel-plugin/ccfbc7c584f15c0fc925957c86bafaca9444d24a/.claude/skills/release/SKILL.md`                                                                  |
| Actual file         | `/Users/meganharrison/.codex/plugins/cache/vercel/vercel-plugin/ccfbc7c584f15c0fc925957c86bafaca9444d24a/.claude/skills/release/SKILL.md`                        |
| Description         | Release vercel-plugin — run gates, bump version, generate artifacts, commit, and push. Use when asked to "release", "ship", "bump and push", or "cut a release". |
| Docs overview       | [Plugin Skills](/skills/plugin-skills)                                                                                                                           |

## Why this exists

Use this page when you want to review the real instructions behind a skill
without leaving the docs site. The content below is copied from the actual
`SKILL.md` file, not rewritten by hand.

## Raw SKILL.md

````md theme={null}
---
name: release
description: Release vercel-plugin — run gates, bump version, generate artifacts, commit, and push. Use when asked to "release", "ship", "bump and push", or "cut a release".
---

# Release

End-to-end release workflow for vercel-plugin.

## Workflow

### 1. Pre-flight checks

Run all gates in parallel:

```bash
bun run typecheck          # tsc --noEmit on hooks/src
bun test                   # all test files
bun run validate           # skill frontmatter + manifest integrity
```

**Stop if any gate fails.** Fix issues before proceeding.

### 2. Determine version bump

Read the current version from `.plugin/plugin.json`. Ask the user which semver component to bump if not specified:

| Bump  | When                                      |
|-------|-------------------------------------------|
| patch | Bug fixes, test/fixture updates, docs     |
| minor | New skills, new hooks, new features       |
| major | Breaking changes to hook API or skill map |

Default to **patch** if the user says "release" without specifying.

### 3. Bump version

Update the `version` field in `.plugin/plugin.json`. This is the **only** version source of truth.

### 4. Rebuild generated artifacts

```bash
bun run build              # hooks (tsup) + manifest
```

This compiles `hooks/src/*.mts` → `hooks/*.mjs` and regenerates `generated/skill-manifest.json`.

### 5. Stage, commit, and push

```bash
git add -A
git commit -m "<summary>; bump to <new-version>"
git push
```

Commit message style: match existing convention — descriptive summary followed by `; bump to X.Y.Z` (see git log for examples).

The pre-commit hook will re-run typecheck and recompile hooks automatically. If it fails, fix the issue and create a **new** commit (never amend).

## Version source of truth

`.plugin/plugin.json` — the `version` field. There is no `package.json` version to sync.

## Checklist (copy into your reasoning)

- [ ] typecheck passes
- [ ] tests pass
- [ ] validate passes
- [ ] `.plugin/plugin.json` version bumped
- [ ] `bun run build` succeeded
- [ ] commit includes all changes
- [ ] pushed to main

````