---
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:

```bash
.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 `docs/workflow/.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