---
description: "Step-by-step deployment runbook for cutting releases without improvising."
---

# deploy-runbook

A skill that turns the release procedure into a checklist the agent follows step by step. Prevents partial releases and skipped steps.

## When to use

Activate when the operator says "release", "cut a release", "publish", or similar. The skill enforces the fixed procedure.

## What it does

1. Bumps the version in `package.json` (the only place the version lives).
2. Writes the per-version changelog at `releases/vX.Y.Z.md`.
3. Runs the release script (`prepare_release.sh` or equivalent).
4. Confirms the tag was created.
5. Stops before pushing — the operator pushes the tag explicitly.

## Rules

- Never improvise a partial release. If any step fails, stop and report.
- Never commit binaries.
- The changelog must cover the full operator-facing delta since the previous tag, not just the latest commit.
- Pre-existing failures in unrelated packages must be fixed, not skipped.