# /ork:swarm-migrate playground

Paste a spec, see the topology DAG and the simulated ledger. Spec format: `swarm-specs/<name>.yaml`. Docs in SKILL.md.

## Why this skill

275-session insights audit showed 25 sessions burned coordinating cross-repo PR cascades manually (M164 deploy-migration, M17 yg-mcp-core extraction, @v1 reusable workflow across 14 repos). The shape was always the same: pick a repo, branch, transform, push, watch CI, repeat. `/ork:swarm-migrate` turns the coordinator into a YAML file and the workers into parallel subagents.

## 1. Paste your spec

Use the example or your own. One transform per spec; topology via `upstream` edges.

name: bump-actions-checkout-v4 description: "Pin @actions/checkout to v4 across all repos" repos: - path: ~/coding/yonatan-hq/platform upstream: [] - path: ~/coding/yonatan-hq/ventures/jobscraper upstream: [platform] - path: ~/coding/yonatan-hq/ventures/trading-ai upstream: [platform] - path: ~/coding/yonatan-hq/ventures/realconnect upstream: [jobscraper, trading-ai] transform: type: regex command: "sed -i '' 's|checkout@v3|checkout@v4|g' .github/workflows/*.yml" verify: - command: "grep -r 'checkout@v3' .github/workflows" expect: nonzero pr: branch_prefix: chore/bump-checkout-v4 title: "chore(ci): pin @actions/checkout to v4" base: main ci_gate: required_checks: [build, test] timeout_minutes: 20 on_failure: pause max_parallel: 4
—

## 2. Topology (waves)

waiting for spec…

## 3. Simulated execution ledger

What the live `.swarm-state.json` would look like at the moment wave 1 starts. merged CI pending blocked-on-upstream novel-failure-paused

repo | wave | status | PR | CI | last action
--- | --- | --- | --- | --- | ---

## 4. What this skill does NOT do

- Does NOT merge PRs. Workers open them; humans (or `gh pr merge --auto`) merge.
- Does NOT force-push. Conflicts surface to the coordinator.
- Does NOT roam outside the spec's `repos[]`. Even if the transform would help elsewhere.
- Does NOT auto-resolve merge conflicts — the most common place auto-fixers ship broken code.