site-migrationlisted
Install: claude install-skill sharabarinillia/SEO-GEO-Vercel-Playbook-Skill
# Site migration without losing rankings
Search engines rank URLs. When URLs change, rankings move to the new URLs only if every old URL
answers a **permanent redirect straight to its closest new page**. Most traffic lost in a
relaunch comes from missing or wrong redirects, not from the new design.
## Steps
1. **Inventory every old URL** (before anything is switched off):
- Search Console → Pages and Performance exports (the URLs that have impressions or links).
- The old site's sitemaps, and a crawl of the live site (any crawler, or a Firecrawl `map`).
- Old URL patterns that may still be linked: `/en/…`, `/post/…`, `/index.php?id=…`, PDFs.
2. **Map each old URL to its closest new page** in a CSV (`old,new`). Old posts without a new
equivalent go to their topic page or the home page; never redirect everything to the home page
by default. See [references/runbook.md](references/runbook.md).
3. **Implement the redirects as permanent** (301 or 308; Google treats both as permanent) in the
host config: [references/vercel-redirects.md](references/vercel-redirects.md). Anchor every
pattern (`^/contact$`) so an old URL can never catch a new one (`/contact/`).
4. **Decide the canonical host and URL form** and redirect the rest: apex → `www` (or the
reverse), `http` → `https`, `/path` → `/path/` (or the reverse), `/index.html` → `/`.
5. **Test on the preview deployment** before the DNS switch:
```bash
node <skill>/scripts/check-redirects.mjs --map redi