Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Release v0.1.16: squash-merge detection, CI caching, and docs

Maximilian Roos0275cf40be70
diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.md
new file mode 100644
index 000000000..cf0312fb2
--- /dev/null
+++ b/.claude/skills/release/SKILL.md
@@ -0,0 +1,43 @@
+---
+name: release
+description: Worktrunk release workflow. Use when user asks to "do a release", "release a new version", "cut a release", or wants to publish a new version to crates.io and GitHub.
+---
+
+# Release Workflow
+
+## Steps
+
+1. **Run tests**: `cargo run -- hook pre-merge --force`
+2. **Review CHANGELOG**: Check `## Unreleased` section covers notable changes since last release
+3. **Determine version**: Patch (bug fixes), minor (new features), or major (breaking changes)
+4. **Update CHANGELOG**: Change `## Unreleased` to `## X.Y.Z`
+5. **Bump version**: Update `version` in `Cargo.toml`, run `cargo check` to update `Cargo.lock`
+6. **Commit**: `git add -A && git commit -m "Release vX.Y.Z"`
+7. **Push to main**: `git push origin <branch>:main`
+8. **Tag and push**: `git tag vX.Y.Z && git push origin vX.Y.Z`
+
+The tag push triggers the release workflow which builds binaries and publishes to crates.io.
+
+## CHANGELOG Review
+
+Check commits since last release for missing entries:
+
+```bash
+git log v<last-version>..HEAD --oneline
+```
+
+Notable changes to document:
+- New features or commands
+- User-visible behavior changes
+- Bug fixes users might encounter
+- Breaking changes
+
+Skip: internal refactors, doc-only changes, test additions (unless user-facing like shell completion tests).
+
+## Version Guidelines
+
+- **Patch** (0.1.x → 0.1.y): Bug fixes only
+- **Minor** (0.x.0 → 0.y.0): New features, non-breaking changes
+- **Major** (x.0.0 → y.0.0): Breaking changes (rare in early development)
+
+Current project status: early release, breaking changes acceptable, optimize for best solution over compatibility.
diff --git a/docs/content/faq.md b/docs/content/faq.md
index 16d13a834..82672de79 100644
--- a/docs/content/faq.md
+++ b/docs/content/faq.md
@@ -129,11 +129,3 @@ Shell integration tests require bash, zsh, and fish:
```bash
$ cargo test --test integration --features shell-integration-tests
```
-
-### Releases
-
-1. **Update the changelog**: Move items from `## Unreleased` to a new version section
-2. **Bump version and commit**: Update `Cargo.toml` version, commit with "Release x.y.z"
-3. **Merge to main**: `wt merge --no-remove` (squashes to main, keeps worktree for tagging)
-4. **Tag and push**: `git tag vX.Y.Z main && git push origin vX.Y.Z`
-5. **Update Homebrew**: After CI completes, run `./dev/update-homebrew.sh`