Migrate

Keeps your workflow files up to date with how the system is designed to work. Runs all pending migrations automatically.

Instructions

Run the migration script:

.claude/skills/migrate/scripts/migrate.sh

If files were updated

The script will list which files were updated. Present this to the user:

{list from script output}

Review changes with git diff, then proceed when ready.

Wait for user acknowledgment before returning control to the calling skill.

If no updates needed

All documents up to date.

Return control silently - no user interaction needed.

Notes

• This skill is run automatically at the start of every workflow skill

• Migrations are tracked in .workflows/.state/migrations (one migration ID per line)

• The orchestrator skips entire migrations once recorded — individual scripts don't track

• To force re-running all migrations, delete the tracking file

• Each migration is idempotent - safe to run multiple times