Migration

Atomic migration steps. Each one validated before the next.

Community pattern — copy this YAML and adapt the migration gate to your project. Not available as a built-in via gump run.

When to use

For database schema migrations, API version upgrades, or major dependency bumps.

The workflow

name: migration
max_budget: 10.00

steps:
  - name: plan
    type: split
    get:
      prompt: |
        Plan migration for: {spec}
        Order steps by dependency. Each step must be independently reversible.
    run:
      agent: claude-opus
    gate: [schema]
    hitl: before_gate
    each:
      - name: migrate
        type: code
        get:
          prompt: |
            Execute migration step: {task.description}
            Ensure backward compatibility where possible.
            Only modify: {task.files}
        run:
          agent: claude-sonnet
          guard:
            max_turns: 60
        gate:
          - compile
          - test
          - bash: "make migration-dry-run"
        retry:
          - attempt: 3
            agent: claude-opus
          - exit: 4

  - name: quality
    gate: [compile, test]