release

Create GitHub Release

You are helping the user create a GitHub release for ClaudeForge.

Prerequisites Check

1. Verify on main branch

   git branch --show-current
   

   • Should be main
   • If not, git checkout main && git pull

2. Check for uncommitted changes

   git status
   

   • Should be clean

3. Verify CHANGELOG.md updated

   grep -A 10 "## \[" CHANGELOG.md | head -15
   

   • Should have entry for new version

Workflow

1. Determine Version

   • Ask user for version number
   • Validate semantic versioning format (X.Y.Z)
   • Examples: 1.1.0, 1.0.1, 2.0.0-beta.1

2. Check Tag Doesn't Exist

   git tag -l "v1.1.0"
   

   • Should return nothing
   • If tag exists, ask user to choose different version

3. Verify CHANGELOG.md

   • Check if version is documented
   • Extract release notes for this version
   • Show preview to user

4. Run Release Workflow

   Option 1: Via GitHub CLI

   gh workflow run release.yml \
     -f version=1.1.0 \
     -f prerelease=false \
     -f draft=false
   

   Option 2: Via GitHub UI

   • Go to Actions → Create Release
   • Click "Run workflow"
   • Enter version: 1.1.0
   • Select options (prerelease, draft)
   • Click "Run workflow"

5. Monitor Workflow

   gh run list --workflow=release.yml --limit 1
   gh run watch
   

6. Verify Release Created

   gh release list
   gh release view v1.1.0
   

Release Types

Stable Release:

• Version: X.Y.Z (e.g., 1.1.0)
• Prerelease: false
• Draft: false
• Published immediately

Pre-Release:

• Version: X.Y.Z-beta.N (e.g., 1.2.0-beta.1)
• Prerelease: true
• Draft: false
• Marked as pre-release on GitHub

Draft Release:

• Version: X.Y.Z
• Draft: true
• Not published until manually approved

Release Notes Generation

The release workflow automatically:

1. Extracts notes from CHANGELOG.md
2. Adds installation instructions
3. Lists commits since last release
4. Includes full changelog link