This skill creates a rollback-aware migration plan for existing sites. It is planning and validation-first, not a production mutation tool.
Operating Modes
url-map: map old URLs to new URLs and identify canonical decisions.redirect-plan: plan 301/302 rules without applying them.seo-surface: preserve titles, descriptions, headings, schema, sitemap, robots, llms.txt, and internal links.launch-checklist: define pre-launch, launch, and post-launch verification.rollback: prepare rollback, monitoring, and alert criteria.
Required Workflow
- Read references/migration-safety-contract.md.
- Start from
existing-site-analyzerevidence andrebuild-or-improve-advisordecision. - Use assets/migration-plan.template.md.
- Build a URL/change map:
- old URL;
- new URL;
- status;
- redirect type;
- canonical rule;
- metadata/schema preservation note.
- Add sitemap, robots, schema, internal links, llms.txt, analytics, and webmaster verification checks.
- Mark production actions as
Planneduntil the user explicitly approves deploy, DNS, redirects, GSC/webmaster, or server changes.
Safety Rules
- Do not apply redirects, edit robots/sitemap in production, deploy, change DNS, or submit GSC/webmaster changes without explicit approval.
- Do not store private analytics exports, tokens, cookies, or verification codes in the plan.
- Do not mark migration checks
Ranunless the command or artifact exists. - If high SEO risk remains, block launch handoff until rollback and monitoring are defined.
Handoff Shape
Migration mode:
Decision source:
URL map path:
Redirect plan:
SEO surface preservation:
Launch approvals needed:
Rollback plan:
Monitoring:
Next owner:
Checks:
Validation
When editing this skill, run:
python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/migration-planner
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/migration-planner
python3 -m json.tool $CODEX_HOME/skills/migration-planner/evals/evals.json >/dev/null