Release Process for atomic-agents

Overview

This skill guides the release process for atomic-agents, including version bumping, PyPI publishing, and GitHub release creation.

Prerequisites

• Must be on

  main

  branch with clean working directory

• .env

  file must contain

  PYPI_TOKEN

  environment variable
• Must have push access to the repository

Release Types

major

minor

patch

Step-by-Step Process

1. Prepare the Branch

git checkout main
git pull
git status  # Ensure clean working directory

2. Run Build and Deploy Script

Important: The script bumps versions, so if it fails partway through, reset to main before retrying.

powershell -ExecutionPolicy Bypass -File build_and_deploy.ps1 <major|minor|patch>

This script will:

• Read current version from

  pyproject.toml

• Increment version based on release type
• Update

  pyproject.toml

  with new version
• Run

  uv sync

  to update dependencies
• Run

  uv build

  to create distribution packages
• Run

  uv publish

  to upload to PyPI

3. If Script Fails - Reset and Retry

git checkout main
git reset --hard origin/main
# Fix the issue, then run script again

4. Commit and Push Version Bump

git add pyproject.toml uv.lock
git commit -m "Release vX.Y.Z"
git push

5. Create GitHub Release

gh release create vX.Y.Z --title "vX.Y.Z" --notes "RELEASE_NOTES_HERE"

Release Notes Template

## What's New

### Feature Name
Brief description of the feature.

#### Features
- Feature 1
- Feature 2

#### Improvements
- Improvement 1

#### Bug Fixes
- Fix 1

### Full Changelog
https://github.com/BrainBlend-AI/atomic-agents/compare/vOLD...vNEW

Checklist

• On main branch with clean working directory

• .env

  file has

  PYPI_TOKEN

• Determined correct release type (major/minor/patch)
• Build and deploy script completed successfully
• Version bump committed and pushed
• GitHub release created with release notes