WooCommerce
woo-hpos-live-migration
Migrate WooCommerce orders to HPOS
Moves a live WooCommerce store from posts storage to HPOS through compatibility checks, staging, synchronization, verification, cut-over and rollback.
- Area
- WooCommerce
- Checked against
- WooCommerce 11.1.2
- Last verified
- 26 September 2026
- Files
- SKILL.md, 7 references, 3 scripts
How it works
- 1Read the current HPOS state, WooCommerce version, settings and order counts.
- 2Audit plugins, themes, custom code, snippets and outside systems for compatibility.
- 3Rehearse the full migration on a staging copy of production.
- 4Enable compatibility mode, backfill HPOS and watch synchronization.
- 5Verify parity with status, data verification, order differences and SQL checks.
- 6Switch to HPOS after verification and keep compatibility mode on during the soak period.
- 7Turn compatibility mode off after testing, then clean legacy data only when approved.
Use it when
- Move a store from posts storage to HPOS.
- Diagnose a stalled or incomplete HPOS migration.
- Investigate order differences or failures after switching storage.
- Plan a rollback from HPOS to posts storage.
How it stays safe
- Runs read commands until the user approves a specific change step.
- Takes a tested backup before every change and verifies the result afterward.
- Rehearses the complete path on staging before production.
- Rolls back through synchronization so orders created after a backup are preserved.
Install it
Copy the whole woo-hpos-live-migration folder into your agent's skills folder, not only SKILL.md.
git clone --depth 1 https://github.com/hamzaahmadaslam/agent-skills.git
cp -R agent-skills/woo-hpos-live-migration "<your agent's skills folder>/"