superpowers-sage:migrating

Migrate WordPress content and database data into Sage/Acorn-compatible models.

13|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-migrating
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-sage:migrating
Source: https://github.com/hekivo/superpowers-sage/tree/main/skills/migrating
Command: npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-migrating

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

WordPress sites often need risky data-changing migrations (content, postmeta, terms, attachments, and legacy plugin structure), and teams need a reliable way to migrate without losing data or ending up with a non-revertible mess.

Core Features & Use Cases

  • 7-phase, safety-harness migration contract: snapshot-before, dry-run compute, human approval gate, preflight checks, apply with row-level logging, snapshot-after verification, and idempotency proof.
  • Destructive-first is forbidden: it enforces snapshot-before and blocks autonomous apply until you explicitly approve the dry-run diff.
  • Common WordPress migration scenarios: post_content rewrites (shortcodes to Blade, markup updates), postmeta cleanup, term taxonomy fixes, attachment regeneration, user role migration, and bulk option updates (including serialized data).
  • Sage/Acorn-specific migration intent: guides safe reversible moves toward Bedrock wp-content structure and modern Roots service provider / Composer-style patterns, including legacy plugin-to-Acorn migrations.

Quick Start

Instruct your AI assistant to run: “Use superpowers-sage:migrating to migrate classic theme data safely with snapshot-before, dry-run diff, and only apply after I approve; start with migration name ‘my-migration’ and target scope ‘pages+postmeta’.”

Frequently Asked Questions about superpowers-sage:migrating

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely migrate WordPress postmeta and post_content to a Sage theme?

To safely migrate WordPress data to Sage, create a snapshot-before backup, compute a dry-run diff, and apply changes only after explicit human approval to prevent data loss. The process enforces preflight validation and logs row-level changes for verification.

What is the safest way to migrate legacy plugin structures to Acorn service providers?

Migrating legacy plugin structures to Acorn requires a 7-phase safety contract: snapshot-before, dry-run compute, human approval gate, preflight checks, apply with logging, snapshot-after verification, and idempotency proof to guarantee reversible moves.

Can I re-run a WordPress database migration if it fails halfway through?

Yes, WordPress database migrations are guaranteed to be idempotent, meaning re-running them produces the same result without duplicating changes. The migration provides row-change proofs to verify each re-run against the expected state.

Does the Sage migration process support serialized option updates and taxonomy fixes?

Yes, the Sage migration process supports bulk option updates including serialized data, term taxonomy fixes, attachment regeneration, and postmeta cleanup within defined scopes while enforcing snapshot-before and snapshot-after verification.

Why do I need to approve a dry-run diff before migrating WordPress data?

You must approve a dry-run diff because the migration process forbids destructive-first actions and blocks autonomous apply until you explicitly confirm the changes. This human approval gate prevents irreversible data loss during content and postmeta rewrites.

What preflight checks are required before migrating classic WordPress theme data to Bedrock?

Preflight checks required before migrating classic WordPress theme data to Bedrock include orphan checks and validation within defined scopes. These checks run after human approval of the dry-run diff but before applying any row-level changes to the database.