docs: require fidelity-first Astro migration

CLAUDE.md

@@ -36,19 +36,24 @@ For the migration task:
 
 1. Read `AGENTS.md`.
 2. Read `MIGRATION_BRIEF.md`.
-3. Inspect the local mirror.
-4. Provide a concise implementation plan.
-5. Scaffold or update the Astro project in `./www`.
-6. Build extraction, crawl, audit, sitemap, and redirect tools.
-7. Extract content, media, metadata, navigation, and forms.
-8. Refactor into reusable Astro components.
-9. Configure Astro content collections and Front Matter CMS.
-10. Add English, Arabic, and Spanish structure.
-11. Add RTL CSS for Arabic.
-12. Add SEO, sitemap, robots, redirects, and reports.
-13. Run build and audits.
-14. Fix practical errors.
-15. Document incomplete items in `reports/migration-summary.md`.
+3. Inspect the live public site as the single source of truth.
+4. Inspect the local mirror as a convenient extraction aid and identify
+   relevant discrepancies.
+5. Inspect the relevant live HTML, CSS, assets, and responsive behavior.
+6. Provide a concise implementation and visual-validation plan.
+7. Scaffold or update the Astro project in `./www`.
+8. Build extraction, crawl, audit, sitemap, and redirect tools.
+9. Extract content, media, metadata, navigation, and forms.
+10. Refactor genuinely repeated patterns into reusable Astro components.
+11. Compare rendered pages with the live site at desktop and mobile widths.
+12. Configure Astro content collections and Front Matter CMS.
+13. Add English, Arabic, and Spanish structure.
+14. Add RTL CSS for Arabic.
+15. Add SEO, sitemap, robots, redirects, and reports.
+16. Run build and audits.
+17. Fix practical errors.
+18. Document incomplete items and intentional visual deviations in
+    `reports/migration-summary.md`.
 
 ## Important Claude-specific behavior
 
@@ -60,6 +65,15 @@ When asked to begin migration, first read the relevant project files, then work
 
 Treat `./www.azinstitute4autism.com` as read-only source material.
 
+Treat the live public site as the single content and visual source of truth.
+Use the mirror only as a convenient local extraction and inspection aid. When
+the live site and mirror disagree, follow the live site and document material
+discrepancies. This migration is not a redesign. Do not substitute a generic
+visual system for the live design.
+
+Treat the `migration-foundation` branch as reference-only. Do not use it as the
+visual baseline.
+
 Do not delete or overwrite raw source assets.
 
 Do not remove files unless you are certain they are generated output in `./www`.
@@ -105,4 +119,4 @@ When finished, report:
 - redirect status
 - build status
 - audit status
-- manual review items
+- manual review items