releasing-kata

name	releasing-kata
description	Use this skill when releasing Kata CLI, Symphony, or the Pi Symphony extension, bumping versions, updating changelogs, or creating release PRs. Triggers include "release", "bump version", "publish", "create release PR", "ship it", "cut a release".

Releasing Kata

Kata has three active independently versioned release targets. Ask which target if not clear from context.

Target	Package	Tag Format	Reference
CLI	@kata-sh/cli	cli-vX.Y.Z	references/cli-release.md
Symphony	symphony (Rust binary)	symphony-vX.Y.Z	references/symphony-release.md
Pi Symphony Extension	@kata-sh/pi-symphony-extension	pi-symphony-vX.Y.Z	references/pi-symphony-extension-release.md

Root package.json version is 0.0.0 — never touch it. The root may contain Pi package manifest metadata for monorepo git installs, but it is not the version source for any release. Each app or package owns its own version. Versions are independent and do not need to match.

Version semantics

Type	When	Example
patch	Bug fixes, small improvements	0.4.9 → 0.4.10