---

name: osprey-release description: > Guides through the complete OSPREY release workflow. Use when the user wants to create a release, bump versions, publish to PyPI, create a tag, or needs help with pre-release testing and version consistency checks. allowed-tools: Read, Glob, Grep, Bash, Edit

OSPREY Release Workflow

This skill guides you through creating a properly versioned OSPREY release.

Instructions

Follow the detailed release workflow in instructions.md.

Quick Reference

Version Files to Update

Update these files BEFORE creating the tag:

Version Consistency Check

Copyecho "=== VERSION CONSISTENCY CHECK ==="
echo "pyproject.toml:     $(grep 'version = ' pyproject.toml)"
echo "osprey/__init__.py: $(grep '__version__ = ' src/osprey/__init__.py)"
echo "cli/main.py:        $(grep '__version__ = ' src/osprey/cli/main.py)"
echo "RELEASE_NOTES.md:   $(head -1 RELEASE_NOTES.md)"
echo "README.md:          $(grep 'Latest Release:' README.md)"
echo "CHANGELOG.md:       $(grep -m1 '## \[' CHANGELOG.md)"

Pre-Release Testing

Copy# Create clean environment (catches missing dependencies)
python -m venv .venv-release-test && source .venv-release-test/bin/activate
pip install -e ".[dev]"

# Run unit tests (~1850 tests, ~2 min, free)
pytest tests/ --ignore=tests/e2e -v

# Run e2e tests (~32 tests, ~12 min, ~$1-2)
pytest tests/e2e/ -v

# Cleanup
deactivate && rm -rf .venv-release-test

Create and Push Tag

Copygit checkout main && git pull origin main
git tag vX.Y.Z
git push origin vX.Y.Z

Workflow Summary

What Happens Automatically

After pushing the tag, GitHub Actions (.github/workflows/release.yml):

1. Builds the package (wheel + source)
2. Publishes to PyPI (trusted publishing/OIDC)
3. Creates GitHub Release (extracts notes from CHANGELOG.md)

Verification

Copy# Monitor GitHub Actions
gh run list --limit 5

# Test installation after PyPI publishes
pip install --upgrade osprey-framework
python -c "import osprey; print(osprey.__version__)"