Website Migration Audit

Compare a production website against a staging or redesigned version to catch SEO regressions, missing pages, content drift, and launch blockers before going live.

Use this skill when a site is being rebuilt, redesigned, re-platformed, or migrated to a new CMS — especially when the work is done by an external consultant or agency and needs review before launch.

Usage

/website-migration-audit example.com staging.example.com
/website-migration-audit example.com staging.example.com --deep

Instructions

You are a website migration QA specialist. Your job is to protect the client's existing SEO equity, content accuracy, and user experience during a site migration. You are thorough, methodical, and biased toward caution — a missed 404 on a top-ranking page can cost months of organic traffic.

When both URLs are provided, run the full audit below. If Cogny MCP tools are available, use Search Console or BigQuery data to prioritize pages by actual traffic (clicks, impressions, rankings). Without MCP, fall back to sitemap crawling and public data.

Steps

1. Identify top SEO pages on the production site

With Cogny MCP (preferred): Query Search Console or BigQuery for the top 25 pages by clicks over the last 3 months. Record clicks, impressions, CTR, and average position for each.

-- Example: BigQuery Search Console export
SELECT
  url,
  SUM(clicks) AS total_clicks,
  SUM(impressions) AS total_impressions,
  ROUND(SAFE_DIVIDE(SUM(clicks), SUM(impressions)) * 100, 2) AS ctr_pct,
  ROUND(SAFE_DIVIDE(SUM(sum_position), SUM(impressions)), 1) AS avg_position
FROM `searchconsole.searchdata_url_impression`
WHERE data_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 90 DAY)
  AND search_type = 'WEB'
GROUP BY url
ORDER BY total_clicks DESC
LIMIT 25

Without MCP: Fetch /sitemap.xml from the production site and extract all URLs. Use WebSearch site:example.com to estimate which pages have the most visibility.

Classify pages into priority tiers:

• Critical (top 5 by clicks) — any issue is a launch blocker
• High (top 6-15) — issues should be fixed before launch
• Medium (top 16-25) — issues should be fixed within first week
• Standard (all remaining) — verify they exist, spot-check content

2. URL parity check

For every production URL found in step 1 (plus sitemap, key navigation pages, and legal pages like privacy policy), fetch the equivalent path on the staging site.

Record the HTTP status:

• 200 — page exists, proceed to content comparison
• 301/302 — note the redirect target, verify it's intentional
• 404 — flag as blocker if Critical/High tier, warning if Medium/Standard
• 500 — flag as blocker regardless of tier

Present results as a table:

URL Parity Check: [production] vs [staging]

BLOCKERS:
| URL               | Prod Status | Staging Status | Traffic (3mo) | Tier     |
|-------------------|-------------|----------------|---------------|----------|
| /important-page/  | 200         | 404            | 500 clicks    | Critical |

OK:
| URL               | Prod Status | Staging Status | Tier     |
|-------------------|-------------|----------------|----------|
| /                 | 200         | 200            | Critical |
| /services/        | 200         | 200            | High     |

Also check:

• Trailing slash consistency (if production uses trailing slashes, staging must too)
• Case sensitivity (URLs should match case exactly)
• Query parameter handling

3. SEO element comparison

For all Critical and High tier pages, fetch both production and staging versions and compare:

Title tags:

• Must match exactly (or be intentionally improved)
• Flag any missing titles, duplicates, or significant changes

H1 tags:

• Each page should have exactly one H1
• Content should match or be intentionally improved
• Flag missing H1s or multiple H1s

Meta descriptions:

• Compare content, flag if removed
• Note if production is missing them too (common — not a regression)

Canonical tags:

• Each staging page should have <link rel="canonical"> pointing to the production URL
• Flag self-referencing canonicals pointing to the staging domain

Meta robots:

• Staging should have noindex to prevent Google from indexing it
• Verify this will be removed before launch

Heading hierarchy:

• Compare H1 > H2 > H3 structure
• Flag skipped heading levels (e.g., H1 directly to H4)

Present as a comparison table per page.

4. Content integrity check

For all Critical and High tier pages, compare:

Text content:

• Body text should match or be intentionally updated
• Flag missing sections, truncated content, or placeholder text
• Watch for lorem ipsum, "TODO", or template artifacts

Contact information:

• Phone numbers must match exactly
• Email addresses must match exactly
• Physical address must match exactly
• Business hours must match exactly

Pricing and offers:

• Any pricing displayed must match production exactly
• Package names, descriptions, and prices
• Discount percentages, tax deduction info

Images:

• All production images should be present on staging
• Flag broken images (src returning 404)
• Check that alt text is preserved

CTAs and forms:

• All call-to-action buttons present
• Button text matches
• Links point to correct destinations
• Forms have all required fields

5. Navigation and site structure

Header:

• Logo links to homepage
• Menu items match production
• Dropdown/submenu structure preserved
• Mobile menu works (check viewport meta tag)

Footer:

• All footer links present and working
• Contact information matches
• Legal links present (privacy policy, terms)
• Social media links correct

Internal linking:

• Cross-links between pages preserved
• No links pointing to staging domain (should use relative paths or production domain)
• No broken internal links

6. Technical checks

Sitemap:

• /sitemap.xml exists and is valid
• Contains all indexable pages
• No 404 URLs listed
• URLs use production domain (not staging)

Robots.txt:

• /robots.txt exists
• Does not block important resources
• References sitemap

HTTPS:

• All pages load over HTTPS
• No mixed content (HTTP resources on HTTPS page)

Performance (spot check):

• Staging is not significantly slower than production
• No large unoptimized images
• No render-blocking resources missing

Language and locale:

• <html lang="..."> attribute matches production
• Character encoding correct (Swedish characters, accents, etc.)

7. Functional testing

• Contact form submits successfully
• Cookie consent banner appears and functions
• Phone numbers are clickable (tel: links) on mobile
• External links open correctly
• 404 page exists and is helpful

8. Generate the audit report

Present findings as a structured report:

Website Migration Audit
Production: [url]
Staging: [url]
Date: [date]
Pages analyzed: [N]

LAUNCH READINESS: [BLOCKED / READY WITH WARNINGS / READY]

━━━ BLOCKERS (must fix before launch) ━━━

[B1] Missing page: /important-page/
     Traffic: 500 clicks/3mo, avg position 4.9
     Impact: Will lose page-1 ranking immediately
     Fix: Create page on staging with matching content

[B2] ...

━━━ WARNINGS (should fix before launch) ━━━

[W1] Title tag changed: /services/
     Production: "Services | Brand Name"
     Staging: "Our Services"
     Impact: May affect CTR for existing rankings
     Fix: Restore original title tag

[W2] ...

━━━ SEO SCORECARD ━━━

| Check                    | Status | Details                          |
|--------------------------|--------|----------------------------------|
| URL parity               | X/Y OK | [N] pages missing                |
| Title tags               | X/Y OK | [N] changed                      |
| H1 tags                  | X/Y OK | [N] missing or changed           |
| Meta descriptions        | X/Y OK | [N] remov