multi-branch-cluster-setup

Installation
SKILL.md

Multi-Branch Cluster Setup

Provisions one minikube cluster per branch supplied by the user. The number of clusters matches the number of branches — 2 branches = 2 clusters, 4 branches = 4 clusters, etc.

Cluster naming and port assignment (dynamic, based on branches provided):

# Cluster name Worktree Branch Dashboard API Gateway
1 ark-cluster-1 $ARK_REPO (main repo, no worktree needed if branch 1 = current) branch 1 :3274 :8080 :8090
2 ark-cluster-2 /tmp/ark-worktree-<branch2-slug> branch 2 :3275 :8081 :8091
3 ark-cluster-3 /tmp/ark-worktree-<branch3-slug> branch 3 :3276 :8082 :8092
N ark-cluster-N /tmp/ark-worktree-<branchN-slug> branch N :3273+N :8079+N :8089+N

Port formula: Dashboard = 3273+N, API = 8079+N, Gateway = 8089+N

Prerequisites check

Run before starting:

Installs
4
GitHub Stars
419
First Seen
Jun 12, 2026
multi-branch-cluster-setup — mckinsey/agents-at-scale-ark