activitypub-release
Version management and release processes using Jetpack Changelogger. Use when creating releases, managing changelogs, bumping versions, or preparing patch releases.
When & Why to Use This Skill
This Claude skill automates version management and software release workflows using Jetpack Changelogger. It streamlines the process of bumping versions, managing changelogs, and preparing major, minor, or patch releases, specifically optimized for WordPress plugin development environments. By integrating with GitHub actions and local scripts, it ensures consistency across version files and maintains a clean, professional project history.
Use Cases
- Automated Release Workflows: Streamline the creation of major and minor releases by automatically updating version numbers across multiple files including package.json, plugin headers, and readme files.
- Changelog Management: Automatically aggregate pull request descriptions into a structured CHANGELOG.md file, ensuring consistent formatting and proper punctuation for professional documentation.
- Patch Release Preparation: Simplify the complex process of creating patch branches, cherry-picking specific commits, and manually updating version headers for urgent bug fixes.
- Semantic Versioning Enforcement: Automatically determine the correct next version number based on the significance of changes (Major, Minor, or Patch) to maintain project integrity and dependency standards.
| name | activitypub-release |
|---|---|
| description | Version management and release processes using Jetpack Changelogger. Use when creating releases, managing changelogs, bumping versions, or preparing patch releases. |
ActivityPub Release Process
Quick reference for managing releases and changelogs for the WordPress ActivityPub plugin.
Quick Reference
Release Commands
npm run release # Create major/minor release PR.
Version File Locations
When updating versions manually, change these files:
activitypub.php- Plugin header (Version: X.Y.Z).readme.txt- WordPress.org readme (Stable tag: X.Y.Z).package.json- npm version ("version": "X.Y.Z").CHANGELOG.md- Changelog file (auto-updated by release script).
Comprehensive Release Guide
See Release Process for complete release workflow and detailed steps.
Release Workflow
Major/Minor Releases
Quick workflow:
# 1. Run release script from plugin root.
npm run release
# Script automatically:
# - Determines version from changelog entries.
# - Updates version numbers in all files.
# - Updates CHANGELOG.md.
# - Creates PR for review.
# 2. Review and merge the release PR.
# 3. Create GitHub release from trunk using the new tag.
See Release Process - Major/Minor for detailed steps.
Patch Releases
Quick workflow:
# 1. Create branch from the tag to patch.
git fetch --tags
git checkout -b tags/5.3.1 5.3.0 # Patch 5.3.0 -> 5.3.1
# 2. Cherry-pick merge commits from trunk (note -m 1 flag).
git cherry-pick -m 1 <commit-hash>
# 3. Update changelog and versions.
composer changelog:write
# Manually update versions in:
# - activitypub.php
# - readme.txt
# - package.json
# 4. Push branch and create GitHub release.
git push -u origin tags/5.3.1
Important: Use -m 1 flag when cherry-picking merge commits to select the mainline parent.
See Release Process - Patch Releases for detailed steps.
Changelog Management
How It Works
Changelogs are managed automatically through the PR workflow:
PR Template (
.github/PULL_REQUEST_TEMPLATE.md):- Check "Automatically create a changelog entry" checkbox.
- Select significance: Patch/Minor/Major.
- Select type: Added/Fixed/Changed/Deprecated/Removed/Security.
- Write message ending with punctuation!
GitHub Action (
.github/workflows/changelog.yml):- Creates changelog file from PR description.
- Validates proper punctuation.
- Saves to
.github/changelog/directory.
Release Process:
npm run releaseaggregates all entries.- Updates
CHANGELOG.mdandreadme.txtautomatically.
Critical Requirements
Always end changelog messages with punctuation:
✅ Add support for custom post types.
✅ Fix signature verification bug.
❌ Add support for custom post types
❌ Fix signature verification bug
Never mention AI tools or coding assistants in changelog messages.
See PR Workflow - Changelog for complete changelog requirements.
Version Numbering
Semantic versioning:
- Major (X.0.0) - Breaking changes.
- Minor (0.X.0) - New features, backward compatible.
- Patch (0.0.X) - Bug fixes only.
The release script determines version automatically from changelog entry significance levels.