project-release

Automate monorepo releases with pre-flight checks, version bumps, changelogs, and atomic git tagging.

1|2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill project-release-parisgroup-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-release
Source: https://github.com/parisgroup-ai/imersao-ia-setup/tree/main/skills/project-release
Command: npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill project-release-parisgroup-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Release management for monorepos is complex and error-prone. This Skill automates pre-flight checks, version bumps, changelog generation, and atomic tagging and pushing to multiple deployment platforms, reducing manual effort and risk.

Core Features & Use Cases

  • Pre-flight state capture and change detection across apps
  • Auto-detect and apply semantic version bumps with optional forced modes
  • Generate changelogs from conventional commits
  • Atomic commit + tag creation and push triggers (CI/CD deployments)
  • Platform-agnostic release flow for Railway, Vercel, Render, Fly.io, and similar
  • Use Case: releasing a web frontend, an API, and worker services in a synchronized manner

Quick Start

Run /project-release to perform a full release or provide a specific bump (patch, minor, major) to force a version update.

Frequently Asked Questions about project-release

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

FAQPage Schema
How do I automate monorepo releases with versioning and changelog generation?

Automate monorepo releases by orchestrating pre-flight checks, semantic version bumps, changelog generation from conventional commits, and atomic git tagging. This coordinates synchronized changes across multiple apps and packages to ensure a strict, auditable release pipeline.

Does this release automation workflow support push-to-main deployments on Railway and Vercel?

Yes, the release workflow is platform-agnostic and supports push-to-main deployments on Railway, Vercel, Render, and Fly.io. It triggers CI/CD deployments through atomic commit and tag creation, coordinating changes across web frontends, APIs, and worker services.

How do I force a semantic version bump during an automated release?

Force a semantic version bump by providing a specific bump type argument like patch, minor, or major when triggering the release command. The automation applies the forced version update alongside standard pre-flight checks and changelog generation.

What is the best way to coordinate synchronized releases across multiple apps in a monorepo?

The best way to coordinate synchronized monorepo releases is using an automated pipeline that captures pre-flight state, detects changes across apps, applies version bumps, and creates atomic git tags. This ensures all web, API, and worker services deploy in unison.

How does changelog generation work with conventional commits in a CI/CD pipeline?

Changelog generation works by parsing conventional commit messages automatically during the release process. It creates an auditable log of changes before applying version bumps and pushing atomic tags to trigger downstream CI/CD platform deployments.

Why do I need pre-flight checks before pushing a versioned release to main?

Pre-flight checks are needed to capture repository state and detect changes across apps before versioning. They act as strict quality gates to prevent error-prone manual releases and ensure atomic tags only push verified, synchronized updates to deployment platforms.