New advertisers: 50% off your first month with code FIRSTMONTHSee slots
agentworkforce avatar

Deploying To Staging Environment

Coordinates multi-repo staging deploys across relay, relay-dashboard, and relay-cloud using git worktrees and GitHub Actions.

GitHub stars
1.1K
last updated
Jun 11, 2026
View on GitHub

What it does

  • Covers pushing main or a feature branch to the staging branch in each of the three repos, one repo at a time
  • Includes worktree-based command sequences for each repo, plus steps to verify the Deploy (Staging) workflow on Fly.io
  • Enforces a fetch-before-push rule and a worktree cleanup step so no stale refs or leftover directories remain
  • Designed for teams testing cross-repo feature branches before promoting changes toward production

Install

$ npx -y skills add agentworkforce/relay --skill deploying-to-staging-environment -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

Files

Deploying to Staging Environment

Overview

The staging environment deployment is a coordinated multi-repo process that synchronizes code across three repositories (relay, relay-dashboard, relay-cloud) and automatically triggers deployment via GitHub Actions. Staging deployments ensure feature verification before production while keeping main branch clean during development.

When to Use

  • Integrating features across repos - Multiple components depend on changes in different repos
  • Testing feature branches together - Verify feature branch changes don't break integration
  • Promoting main to staging - Standard sync to keep staging up-to-date with latest main
  • Verifying deployment readiness - Test infrastructure changes or deployment workflows
  • Cross-team coordination - Share feature branches for integration testing

When NOT to use:

  • Emergency hotfixes (use production deployment instead)
  • Single-repo changes only (push directly if not blocking other repos)
  • Testing without intent to deploy (use local environment instead)

Architecture

The staging deployment system consists of:

Details

Repository
github.com/agentworkforce/relay
Categories
Git & Pull Requests, Cloud & Infrastructure
License
Apache-2.0
First seen
Jun 11, 2026

More from agentworkforce/relay

All 17

Similar to Deploying To Staging Environment

More Git & Pull Requests