recent updates

2026-06-09 18:31:59 +02:00
parent 398b94965c
commit 94f7a1f72a
42 changed files with 8686 additions and 0 deletions
@@ -0,0 +1,50 @@
+{
+  "meta": {
+    "author": "Andre Cobham / Arising Media",
+    "updated": "2026-06-09",
+    "version": "1.0",
+    "description": "WordPress to AM PHP stack migration configuration and run order"
+  },
+  "input": {
+    "format": ".wpress (All-in-One WP Migration backup)",
+    "supported_builders": ["Divi", "Elementor", "classic", "Gutenberg"],
+    "database_format": "MySQL dump extracted from .wpress"
+  },
+  "output": {
+    "stack": "php:8.3-fpm-alpine + nginx + supervisord",
+    "data_layer": "SQLite (one db per content domain)",
+    "assets": "WebP only, baked into Docker image",
+    "routing": "PHP router + nginx location blocks"
+  },
+  "pipeline_phases": [
+    {"phase": 1, "name": "Extract", "description": "Unpack .wpress archive, extract MySQL dump and uploads folder"},
+    {"phase": 2, "name": "Analyze", "description": "Parse WordPress DB dump, detect Divi version, inventory pages, extract content"},
+    {"phase": 3, "name": "Design extraction", "description": "Extract color tokens, typography, layout patterns from Divi CSS"},
+    {"phase": 4, "name": "Content migration", "description": "Rewrite content clean into SQLite pages and page_sections"},
+    {"phase": 5, "name": "Media migration", "description": "Catalog uploads, skip WP-generated size variants, convert to WebP, remap paths"},
+    {"phase": 6, "name": "SEO preservation", "description": "Map old WP URLs to new AM slugs, generate 301 redirect map"},
+    {"phase": 7, "name": "Build", "description": "Scaffold AM project structure, seed SQLite DBs, write PHP templates"},
+    {"phase": 8, "name": "Verify", "description": "Docker build, HTTP 200 all pages, mobile check, SEO audit, zero em-dashes"}
+  ],
+  "rules": [
+    "Never a 1:1 Divi copy. Every migration is a content extraction and redesign",
+    "Never migrate the WordPress database. Content is rewritten cleaner",
+    "Never run headless WordPress or WordPress as API",
+    "Strip all Divi shortcodes, plugin CSS, and JS bundles",
+    "All media converted to WebP before baking into Docker image",
+    "URL slugs cleaned to flat lowercase-hyphen format",
+    "301 redirect map required for all changed URLs"
+  ],
+  "never_migrate": [
+    "wp-admin paths",
+    "Divi shortcode markup",
+    "WordPress plugin CSS/JS",
+    "wp-content/cache",
+    "WordPress user accounts or session data"
+  ],
+  "tooling": {
+    "extraction": "scripts in wp-divi-pipeline-to-am-stack/scripts/",
+    "sop_folder": ".am-webdesign-sops/wp-divi-pipeline-to-am-stack/",
+    "reference_docs": ["00-overview.md", "08-run-order.md", "10-agent-breadcrumbs.md"]
+  }
+}