Shipmates
All commands

Command

/shipmates-migrate

discover → transform each → verify → sweep clean

Find every call site, rewrite them, leave none of the old pattern.

See it run

Illustrative terminal recording of the stages /shipmates-migrate runs, in order.
Illustrative — the stages /shipmates-migrate runs, in order.

How to run it

Run it in your harness

/shipmates-migrate <from → to — e.g. "moment.js → date-fns" or "callback API → async/await">

<angle brackets> = required · [square brackets] = optional

How it works

Engineers rewrite in parallel batches. SDET proves the old pattern is gone. The same review board as /ship-issue then sits — extra seats from the same flags.

  1. Census

    Find every occurrence. Miss one and the migration is not done.

    No specialist — the run must see every call site.

  2. Rewrite

    Several engineers, disjoint files, in parallel. Non-mechanical sites are handled one by one, not blind-replaced.

    Crew

    senior-engineer

  3. Sweep

    Re-search the repo. The old pattern must be gone, and the suite green.

    Crew

    sdet

  4. Land

    Two reviewers sit first; a retry re-selects from the fixer delta. The same flags as /ship-issue pull everyone else.

    Always

    product-manager principal-engineer

    Also sit when

When to use

  • An API, library, or idiom must change everywhere it appears.
  • Behaviour stays, shape changes? /shipmates-refactor. Choice still open? /shipmates-spike.

The skill

The installer ships the full skill — stages, gates, config — from commands/shipmates-migrate.md.

Read the skill on GitHub

Other commands

All commands