wa:deploy-promote

Promote a dev branch to main after CI health and divergence checks.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-deploy-promote
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wa:deploy-promote
Source: https://github.com/jeremy-newhouse/eck-e2e-weather-app/tree/main/.claude/skills/deploy-promote
Command: npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-deploy-promote

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents broken releases by promoting a vetted integration branch (dev) into the production branch (main) only after confirming CI health and branch readiness.

Core Features & Use Cases

  • CI-gated promotion: Blocks promotion when CI is failing on dev.
  • Guarded merge strategy: Supports fast-forward only by default, with an option to use a merge commit strategy when appropriate.
  • Multi-stage workflow with verification: Uses clear stages (pre-check, promote, verify) and confirms main and dev are synchronized after the update.
  • Use Case: In teams following a dev-to-main lifecycle, use this Skill to merge changes for an environment promotion while ensuring the candidate branch has passed CI and the branches end up in sync.

Quick Start

Run wa:deploy-promote to promote the current dev branch to main after verifying CI status and branch divergence.

Frequently Asked Questions about wa:deploy-promote

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

FAQPage Schema
How do I safely merge a dev branch to main only after CI passes?

To safely merge a dev branch to main, you can use a CI-gated promotion workflow that blocks branch promotion when CI validation is failing on the integration branch. This ensures broken releases are prevented by confirming CI health before updating production.

What is the best merge strategy for promoting dev to production in a release workflow?

The best merge strategy for promoting dev to production depends on your history requirements. A fast-forward only strategy is default for clean histories, but you can select a merge commit strategy when appropriate to preserve context during branch promotion.

How do I verify branches are in sync after a dev to main branch promotion?

To verify branches are in sync after branch promotion, use a multi-stage workflow that performs git merge primitives, pushes main, and confirms both dev and main are synchronized afterward. This post-update verification ensures the lifecycle integration succeeded.

Can I use fast-forward only merges for automated E2E dev-to-main updates?

Yes, you can use fast-forward only merges for automated E2E dev-to-main updates. This release workflow supports CI/CD-driven environments by enforcing branch divergence validation and utilizing fast-forward only by default to safely update the production branch.

Why does branch promotion fail when CI validation is failing on the dev branch?

Branch promotion fails when CI validation is failing because the workflow enforces CI health checks before merging. This prevents broken releases by blocking the dev integration branch from updating the main production branch until all CI checks pass.

When do I need branch divergence validation before merging dev to production?

You need branch divergence validation before merging dev to production when following a controlled dev-to-main lifecycle. It ensures the candidate branch has passed CI and checks branch readiness before applying the correct git merge primitive to update main.