gstack-ship

Convert deploy requests into deterministic release workflows with tests and review gates.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tayiorbeii/paperclip-factory-kit --skill gstack-ship-tayiorbeii
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-ship
Source: https://github.com/tayiorbeii/paperclip-factory-kit/tree/main/skills/gstack-ship
Command: npx skills add https://github.com/tayiorbeii/paperclip-factory-kit --skill gstack-ship-tayiorbeii

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents half-finished code from being pushed by turning a “ready to ship” request into a repeatable workflow that updates versioning, changelogs, and release artifacts with review and test gates.

Core Features & Use Cases

  • Branch-safe shipping workflow: Detects the base branch state, merges or reconciles it, and prepares the correct diff for release-grade output rather than an ad-hoc deploy attempt.
  • Test + review + release gating: Runs tests and reviews the resulting changes, then applies the release approval gate flow (including a dual-key Review → Ship split) before creating PR/release actions.
  • Release bookkeeping automation: Bumps VERSION, updates CHANGELOG, commits the ship-ready result, and pushes upstream in a way that supports reproducible shipping.

Quick Start

Say: “Ship it, I’m ready to deploy this change,” and let gstack-ship run the full ship workflow.

Frequently Asked Questions about gstack-ship

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

FAQPage Schema
How do I automate pull request creation and version bumping before deployment?

Automating pull request creation and version bumping involves detecting the base branch, merging it, running tests, and reviewing the diff. This workflow updates the VERSION and CHANGELOG, then commits and pushes the release-ready result with enforced review gates.

What is the best way to ensure tests pass before pushing code to the main branch?

To ensure tests pass before pushing code to the main branch, use a deterministic release workflow that runs tests and reviews the resulting diff. This approach applies an approval gate flow, preventing half-finished code from deploying without passing required checks.

How does a branch-safe shipping workflow handle changelog updates and merges?

A branch-safe shipping workflow handles changelog updates by detecting the base branch state, reconciling or merging it, and preparing the correct diff. It then bumps the VERSION, updates the CHANGELOG, and commits the ship-ready result upstream for reproducible releases.

Can I deploy changes directly without creating a pull request?

You cannot deploy changes directly without passing the release approval gate. The workflow enforces a dual-key Review to Ship split, ensuring that test and review checks are approved before executing any pull request or deployment actions.

Why do I need a release approval gate for shipping code changes?

A release approval gate is needed for shipping code changes to prevent half-finished code from being pushed. It turns a ready-to-ship request into a repeatable workflow that enforces review and test gates before creating pull requests or executing deployments.

Does gstack-ship support reproducible release bookkeeping for version bumps?

Yes, gstack-ship supports reproducible release bookkeeping by automating VERSION bumps, updating the CHANGELOG, committing the ship-ready result, and pushing upstream. This ensures release integrity rather than relying on manual copy-paste steps.