| name | migrate |
| description | Run migrations to keep workflow files in sync with the current system design. This skill is mandatory before running any workflow skill. |
| allowed-tools | Bash(.claude/skills/migrate/scripts/migrate.sh) |
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
