feat(release): auto-increment minor version and add /release skill

Author: Chemaclass

.claude/CLAUDE.md

@@ -86,6 +86,7 @@ Invoke with `/skill-name`:
 | `/add-assertion` | Add new assertion with TDD |
 | `/check-coverage` | Analyze test coverage gaps |
 | `/pre-release` | Pre-release validation checklist |
+| `/release` | Run pre-release checks and execute release |
 | `/commit` | Stage and commit with conventional commits |
 | `/gh-issue <N>` | GitHub issue → branch → implement → PR |
 | `/pr [#N]` | Push branch and create PR |

.claude/skills/release/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: release
+description: Run pre-release validation and execute the release process
+user-invocable: true
+argument-hint: "[version]"
+allowed-tools: Bash, Read, Grep, Glob
+---
+
+# Release
+
+Run pre-release checks and create a new bashunit release.
+
+## Arguments
+
+- `$ARGUMENTS` - Version number (optional, e.g., `0.34.0`). If omitted, auto-increments the minor version.
+
+## Current State
+
+- Current version: !`grep -o 'BASHUNIT_VERSION="[^"]*"' bashunit | cut -d'"' -f2`
+- Branch: !`git branch --show-current`
+- Working tree: !`git status --short`
+- Unreleased changes: !`awk '/^## Unreleased$/,/^## \[/' CHANGELOG.md | head -30`
+
+## Instructions
+
+### 1. Pre-flight validation
+
+Run these checks and report pass/fail for each:
+
+```bash
+# Tests
+./bashunit tests/
+
+# Static analysis
+make sa
+
+# Linting
+make lint
+
+# Bash 3.0+ compatibility (must return no results)
+grep -rn '\[\[' src/ || true
+grep -rn 'declare -A' src/ || true
+
+# CI status
+gh run list --limit 3 --branch main
+```
+
+If ANY check fails, stop and report the issue. Do NOT proceed to release.
+
+### 2. Confirm with user
+
+Show a summary:
+- Version: current → new (from `$ARGUMENTS` or auto-incremented)
+- Key changes from CHANGELOG Unreleased section (abbreviated)
+- All checks passed
+
+Ask the user to confirm before proceeding.
+
+### 3. Execute release
+
+```bash
+./release.sh $ARGUMENTS
+```
+
+If `$ARGUMENTS` is empty, run `./release.sh` (auto-increments minor version).
+
+The script handles everything interactively: version bumps, build, commit, tag, GitHub release, and docs deployment.
+
+### 4. Post-release
+
+After the script completes, verify:
+```bash
+git log --oneline -1
+git tag --list | tail -1
+```
+
+Report the release URL to the user.
+
+## Example Usage
+
+```
+/release
+/release 0.34.0
+/release 1.0.0
+```

release.sh

@@ -47,10 +47,11 @@ CURRENT_VERSION=""
 
 function release::show_usage() {
   cat >&2 <<EOF
-Usage: ./release.sh <version> [options]
+Usage: ./release.sh [version] [options]
 
 Arguments:
   version     The new version number (e.g., 0.30.0)
+              If omitted, auto-increments the minor version (e.g., 0.33.0 → 0.34.0)
 
 Options:
   --dry-run         Preview changes without modifying any files
@@ -68,6 +69,7 @@ Exit Codes:
   2    Execution error (build failed, git failed)
 
 Examples:
+  ./release.sh                            # Auto-increment minor version
   ./release.sh 0.31.0                    # Interactive release
   ./release.sh 0.31.0 --dry-run          # Preview changes
   ./release.sh 0.31.0 --sandbox          # Test in isolated sandbox
@@ -551,6 +553,13 @@ function release::sandbox::run() {
   release::sandbox::cleanup
 }
 
+function release::increment_minor() {
+  local version=$1
+  local major minor
+  IFS=. read -r major minor _ <<<"$version"
+  echo "$major.$((minor + 1)).0"
+}
+
 function release::validate_semver() {
   local version=$1
   if ! regex_match "$version" '^[0-9]+\.[0-9]+\.[0-9]+$'; then
@@ -935,17 +944,17 @@ function release::main() {
     esac
   done
 
-  # Validate version argument
+  # Get current version
+  CURRENT_VERSION=$(release::get_current_version)
+
+  # Auto-increment minor version if not specified
   if [[ -z "$VERSION" ]]; then
-    release::log_error "Version argument is required"
-    release::show_usage
-    exit $EXIT_VALIDATION_ERROR
+    VERSION=$(release::increment_minor "$CURRENT_VERSION")
+    release::log_info "No version specified, auto-incrementing minor: $CURRENT_VERSION → $VERSION"
+  else
+    release::validate_semver "$VERSION"
   fi
 
-  release::validate_semver "$VERSION"
-
-  # Get current version
-  CURRENT_VERSION=$(release::get_current_version)
   release::log_info "Current version: $CURRENT_VERSION"
   release::log_info "New version: $VERSION"
 

tests/unit/release_validation_test.sh

@@ -70,6 +70,26 @@ function test_validate_semver_rejects_text() {
   assert_contains "Invalid version format" "$result"
 }
 
+##########################
+# release::increment_minor tests
+##########################
+
+function test_increment_minor_bumps_minor_version() {
+  assert_equals "0.34.0" "$(release::increment_minor "0.33.0")"
+}
+
+function test_increment_minor_resets_patch_to_zero() {
+  assert_equals "1.3.0" "$(release::increment_minor "1.2.5")"
+}
+
+function test_increment_minor_handles_zero_minor() {
+  assert_equals "2.1.0" "$(release::increment_minor "2.0.0")"
+}
+
+function test_increment_minor_handles_large_numbers() {
+  assert_equals "10.21.0" "$(release::increment_minor "10.20.30")"
+}
+
 ##########################
 # release::version_gt tests
 ##########################