migrate-job
CommandGuided full-job migration flow. Walks the user from "I want to migrate this Databricks job" through DAG → data check → migrate → status, asking before each phase.
/migrate-jobWhat it tells Claude to do
38 linesThe prompt this command injects, verbatim. Worth reading before you run it.
# `/migrate-job` — guided full migration
Drive the migrator end-to-end with checkpoints between phases. Asks the user before running each long-running step so they can abort or adjust.
## Workflow
1. **Confirm prerequisites** (invoke [`aidp-migrator-bootstrap`](../skills/aidp-migrator-bootstrap/SKILL.md) silently — surface any gaps).
2. **Ask for the source** — either a Databricks workspace path OR a Databricks Job ID. Don't proceed without it.
3. **Build the DAG** — invoke [`aidp-build-dag`](../skills/aidp-build-dag/SKILL.md). Show the resulting task count + dep count. Ask "looks right?" before next step.
4. **Data check** — invoke [`aidp-check-data`](../skills/aidp-check-data/SKILL.md). Show the OK/MISSING/EMPTY counts.
- If any MISSING / EMPTY: ask the user how to handle. Options: (a) migrate catalog first via [`aidp-migrate-catalog`](../skills/aidp-migrate-catalog/SKILL.md), (b) configure [`aidp-bucket-mapping`](../skills/aidp-bucket-mapping/SKILL.md), (c) proceed anyway (with a clear warning).
5. **Migrate** — invoke [`aidp-migrate-job`](../skills/aidp-migrate-job/SKILL.md). Surface live log tail.
6. **Status** — when the run finishes, invoke [`/migration-status`](./migration-status.md) on the resulting `JOB_REPORT.md`.
## Args (optional — if user provided them upfront)
$ARGUMENTS
If `$ARGUMENTS` contains a Databricks Job ID or workspace path, jump straight to step 3 (skip the question).
## Checkpoints to surface to the user
Between phases, give the user a 1-line summary + the cost estimate of the next step:
```
[Phase 1/5] DAG built: 7 tasks, 18 dep notebooks, output reports/<MyJob>_manifest.json
[Phase 2/5] About to scan source data on cluster — ~2 min, no token cost. Proceed? (y/N)
...
[Phase 4/5] About to start Pass-2 migration — est. 30-90 min, $10-30 in Claude tokens. Proceed? (y/N)
```
Do not auto-proceed past the migrate step without explicit user confirmation. Pass-2 is expensive.
## When to stop
- User aborts at any checkpoint.
- Data check shows >50% MISSING — likely the catalog hasn't been migrated yet; route to [`/migrate-catalog`](./migrate-catalog.md) instead.
- Cluster is not Active — instruct the user to start it before continuing.Shipped by 1 plugin
Installing any of these installs this command.
What this can do
Capabilities declared in this component's own frontmatter — not inferred.
Inherit all session tools
Declares no tool restrictions — inherits every session tool
~41 tokens of context used while enabled, before you invoke anything
Reviews
Log in to leave a review.
No reviews yet — be the first.
Explore related
Other things in this space — across every part of the ecosystem, not just commands.
Commandssimilar to this one
All commands →modernize-brief
Generate a phased Modernization Brief — the approved plan that transformation agents will execute against
32.8K stars
clean_gone
Cleans up all git branches marked as [gone] (branches that have been deleted on the remote but still exist locally), including removing associated worktrees.
32.8K stars
hookify
Create hooks to prevent unwanted behaviors from conversation analysis or explicit instructions
32.8K stars