release

This skill executes comprehensive release workflows with SDLC validation for multiple project types. It prevents broken, untested, or insecure code from being released.

Supported Project Types

| Type | Detection | Version Tool | Validators | |------|-----------|--------------|------------| | Claude Plugin | .claude-plugin/plugin.json | bump-my-version | plugin.json, agents, skills, commands | | Python | pyproject.toml, setup.py | bump-my-version | pytest, ruff, mypy, bandit, pip-audit | | Node.js | package.json | npm version | npm test, eslint, npm audit | | Go | go.mod | manual | go test, golangci-lint, go vet | | Rust | Cargo.toml | cargo-bump | cargo test, clippy, cargo audit, cargo fmt |

Quick Reference

# Interactive release (prompts for type)
/agents:release

# Specific release types
/agents:release patch      # Bug fixes (0.7.1 → 0.7.2)
/agents:release minor      # New features (0.7.1 → 0.8.0)
/agents:release major      # Breaking changes (0.7.1 → 1.0.0)

# Options
/agents:release --dry-run          # Preview without changes
/agents:release --pr               # Create PR instead of push
/agents:release --force            # Continue despite warnings
/agents:release --coverage=80      # Override coverage threshold

Release Workflow

Execute these phases in order:

Phase 1: Project Detection

Detect project type using cascade detection:

if [ -f ".claude-plugin/plugin.json" ] || [ -f "plugin.json" ]; then
    PROJECT_TYPE="claude-plugin"
elif [ -f "pyproject.toml" ] || [ -f "setup.py" ]; then
    PROJECT_TYPE="python"
elif [ -f "package.json" ]; then
    PROJECT_TYPE="nodejs"
elif [ -f "go.mod" ]; then
    PROJECT_TYPE="go"
elif [ -f "Cargo.toml" ]; then
    PROJECT_TYPE="rust"
else
    PROJECT_TYPE="generic"
fi

Phase 2: Git Status Check

Verify repository state:

echo "Branch: $(git branch --show-current)"
git status --porcelain
git log --oneline @{u}..HEAD 2>/dev/null || git log --oneline -5

Phase 3: SDLC Validation

CRITICAL: Run comprehensive validation before any release.

Use the release validator script:

VALIDATOR="${SKILL_DIR}/scripts/release_validator.py"
python3 "$VALIDATOR" . --coverage-threshold=${COVERAGE:-95} --verbose

The validator checks:

• Tests: Run test suite, verify passing
• Coverage: Enforce 95% minimum (configurable)
• Lint: Check code style and formatting
• Security: Scan for vulnerabilities
• CHANGELOG: Verify [Unreleased] section exists
• Breaking changes: Detect deleted/renamed files
• CI config: Verify workflows exist

If validation fails without --force, prompt:

AskUserQuestion:
- question: "Validation found issues. How to proceed?"
- options:
  - "Fix issues first (Recommended)"
  - "Continue anyway"
  - "Abort release"

Phase 4: Uncommitted Changes

If uncommitted changes exist:

1. Show changes: git diff --stat
2. Prompt for action: commit all, commit staged, skip, or abort
3. Generate conventional commit message based on project type:
   • Claude plugins: feat(agents):, feat(skills):, fix(commands):
   • General: feat:, fix:, refactor:, docs:

Never commit sensitive files: .env*, *.key, *.pem, *credentials*

Phase 5: Version Bump

Execute version bump using appropriate tool:

| Project | Tool | Command | |---------|------|---------| | Claude Plugin | bump-my-version | bump-my-version bump $TYPE | | Python | bump-my-version | bump-my-version bump $TYPE | | Node.js | npm | npm version $TYPE | | Go | manual | Edit go.mod | | Rust | cargo-bump | cargo bump $TYPE |

For --dry-run, show preview without executing.

Phase 6: Push Release

Default (no --pr):

git push --follow-tags

With --pr flag:

BRANCH="release/$(date +%Y%m%d)-v${NEW_VERSION}"
git checkout -b "$BRANCH"
git push -u origin "$BRANCH"
gh pr create --title "chore(release): v${NEW_VERSION}" --body "..."

Phase 7: Summary

Display release summary:

• Project type and path
• Version change (old → new)
• Validation results
• Git status (branch, tags, remote)

Semver Recommendation Logic

The validator recommends version type based on changes:

| Detected | Recommendation | |----------|---------------| | Breaking changes (deleted/renamed files) | major | | New features, significant additions | minor | | Bug fixes, docs, maintenance | patch |

Breaking change detection analyzes git diff since last tag for:

• Deleted files (excluding tests, dotfiles)
• Renamed files (public API changes)

Coverage Threshold

Default: 95% coverage required.

Override methods:

1. Command flag: --coverage=80
2. Project config (pyproject.toml, package.json)
3. Environment: COVERAGE_THRESHOLD=80

Error Handling

Validation Failure

1. Display specific failing checks
2. Show remediation steps
3. Offer --force to continue or abort

Push Failure

1. Fetch and check for conflicts
2. Attempt rebase: git pull --rebase
3. Retry push
4. Fallback: offer PR creation

Version Bump Failure

1. Check for uncommitted version files
2. Verify .bumpversion.toml exists
3. Offer manual version instructions

Safety Rules

• Never force push
• Never skip validation without explicit confirmation
• Always run full validation before release
• Preserve all git history
• Require coverage threshold by default
• Warn on breaking changes

Additional Resources

Scripts

• scripts/release_validator.py - Comprehensive SDLC validation script

References

• references/sdlc-requirements.md - Detailed validation requirements per project type
• references/version-management.md - Version bump tool configurations

Examples

• examples/plugin-release.md - Example Claude plugin release output
• examples/python-release.md - Example Python package release output