Batch Migration Orchestrator

Plan and parallelize broad codebase migrations

Use this skill for sweeping refactors, migrations, bulk renames, or repetitive codebase-wide edits.

Goal

Turn one large request into a safe parallel rollout with independent units, validation, and mergeable outputs.

Workflow

1. Inspect the repo to find every affected area, convention, and dependency.
2. Split the change into independent units by module, directory, or subsystem.
3. Define an end-to-end verification recipe for each unit.
4. Launch workers in parallel only when their write scopes do not overlap.
5. Track completion, collect PRs or patches, and summarize failures.

Guardrails

• Do not parallelize tightly coupled work.
• Do not let workers edit the same files.
• Require each worker to validate its own unit.
• Prefer worktree or isolated branch execution when git is available.

Inputs

• Migration target
• Scope boundaries
• Verification method
• Branch/PR expectations

Source Provenance

Derived from Claude Code bundled skill logic in src/skills/bundled/batch.ts.