release-process-base

Automate version bumping, branch merging, tagging, and CI/CD verification for Git-backed releases.

Updated Mar 18, 2022
One-click install
npx skills add https://github.com/mpaulosky/dotfiles --skill release-process-base
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release-process-base
Source: https://github.com/mpaulosky/dotfiles/tree/main/BaseNewProjectFiles/.squad/skills/release-process-base
Command: npx skills add https://github.com/mpaulosky/dotfiles --skill release-process-base

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill codifies repeatable release procedures so teams avoid manual, error-prone steps when versioning, merging, tagging, and validating CI/CD during releases across ecosystems.

Core Features & Use Cases

  • Version Bumping Patterns: Supports static file bumps, tool-computed versions (NBGV, Maven, Cargo), and tag-only strategies with guidance on where to perform commits.
  • Release PR and Merge Strategies: Decision trees for merge commit, squash, and rebase approaches and recommendations for long-lived vs single-branch models.
  • Tagging, GitHub Releases, and CI Verification: Procedures for annotated tagging, gh release creation, and verifying that workflows trigger and publish artifacts.
  • Diagnostics & Anti-Patterns: Common failure modes, fixes for version mismatches, merge conflicts, and publishing credential issues, plus playbook binding via .release-config.json.

Quick Start

Prepare a release by bumping the version in version.json, creating a Release PR from dev to main, merging with the chosen strategy, tagging v1.2.3, and verifying CI/CD jobs and artifact publication.

Frequently Asked Questions about release-process-base

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate semantic versioning and tagging for a Git release workflow?▼

Automate semantic versioning and tagging by bumping the version in a static file, merging via a Release PR, creating an annotated v1.2.3 tag, and validating CI/CD triggers.

What's the best way to merge a release branch into main using GitHub?▼

The best way to merge a release branch into main depends on your model: use decision trees for merge commit, squash, or rebase strategies to satisfy PR-based release merges.

Do I need a specific CI/CD pipeline to use tag-only versioning for releases?▼

No specific CI/CD pipeline is required for tag-only versioning; it supports tool-computed versions for generic projects and validates CI trigger workflows during artifact publication.

Why does my GitHub release workflow fail with version mismatches and publishing credential issues?▼

Release workflows fail with version mismatches and publishing credential issues due to common failure modes; fixes involve checking .release-config.json bindings and validating CI verification procedures.

Can I use a single release workflow for both .NET and Node.js projects?▼

Yes, you can use a single framework-agnostic release workflow for .NET, Node.js, Python, Java, and generic projects by binding configurations via a project playbook or .release-config.json.