@lynxflow/seo-engine 1.5.1 → 1.5.3

package/dist/index.js

@@ -3649,10 +3649,10 @@ When discovering or listing product modules, features, or services to build the
   - DO NOT create programmatic pages for internal plumbing like: \`/api/stripe\`, \`/api/resend\`, \`/api/auth\`, \`/api/d1\`, \`/api/webhooks\`, \`/api/openai\`.
   - DO NOT expose internal infrastructure, vendors, or suppliers (e.g. Stripe, Resend, Cloudflare D1, Better-Auth, Supabase, PostgreSQL drivers) as public product features. End users never search for or buy your internal backend plumbing.
 - **✅ ALWAYS inspect the FRONTEND user-facing interface & commercial value propositions:**
-  - Read marketing navigation menus & dropdowns (\`components/Navbar.tsx\`, \`components/Header.tsx\`, \`components/Navigation.tsx\`).
-  - Read marketing feature pages & pricing tiers (\`app/(marketing)/*\`, \`pages/features/*\`, \`app/pricing/*\`).
-  - Read dashboard UI workflows & user modules (\`components/dashboard/*\`, \`components/sidebar/*\`).
-  - Identify the actual **benefits and tools the end-user buys** (e.g. "Visual Pipeline Kanban", "Automated Invoice Tracking", "Electronic Signature", "Real-Time Client Portal", "Custom Reporting").
+  - **Step 1A - Marketing Navbars & Dropdowns:** Scan \`components/Navbar.tsx\`, \`components/Header.tsx\`, \`components/Navigation.tsx\` to list all primary product modules.
+  - **Step 1B - Marketing Feature Pages & Pricing:** Scan \`app/(marketing)/*\`, \`pages/features/*\`, \`app/pricing/*\` to list commercial feature names and pricing tiers.
+  - **Step 1C - Dashboard Navigation & User Tools:** Scan \`components/dashboard/*\`, \`components/sidebar/*\` to find actual user workflows.
+  - **Step 1D - Extraction Requirement:** For EACH discovered module (or major product branch), create at least 1 programmatic service entry with \`slug\`, \`name\`, \`category\`, \`description\`, \`keyFeatures\`, and \`priceMonthly\`.
 
 ---
 
@@ -3666,7 +3666,137 @@ When discovering or listing product modules, features, or services to build the
 
 ---
 
-### \uD83C\uDFDB️ 3. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
+### \uD83C\uDFC6 3. THE ARCHITECTURAL PLAYBOOK OF SAAS TITANS (7M+ PAGES WITH 0 DB BOTTLENECKS)
+
+How category leaders generate millions of high-converting pages without server saturation:
+
+1. **Proven Formulas of SaaS Giants:**
+   - ⚡ **Zapier (~25 Million pages):** \`App A × App B\` (e.g. "Connect WhatsApp to Shopify", "Sync Sheets with Notion").
+   - \uD83C\uDFA8 **Canva (~50 Million pages):** \`Template Type × Industry/Theme × Format × Locale\` (e.g. "Restaurant Menu Italian A4").
+   - \uD83D\uDCB8 **Wise (~15 Million pages):** \`Currency Pair × Country × Dynamic Rate Calculator\`.
+   - \uD83D\uDCCA **G2 & Capterra (~10 Million pages):** \`App A vs App B\` / \`Alternative to App X for [Role]\`.
+
+2. **The 4 Pillars of Zero-Latency (< 0.05ms) Resolution:**
+   - **0 Bytes in Database:** Never generate physical static files or query heavy databases per request. Pages are resolved mathematically in RAM upon arrival.
+   - **1 Single Universal Catch-All Route:** \`app/[...slug]/page.tsx\` (or \`app/[locale]/[...slug]/page.tsx\`) handles all matrices through one lightweight layout.
+   - **Edge Caching & ISR:** The rendered HTML is instantly cached at the CDN/Edge (Cloudflare / Vercel Edge) on first request.
+   - **Automatic Siloing & Mesh Linking:**
+     - Links to 3 neighboring geographic cities for the same service.
+     - Links to 4 related professions/industries in the same target category.
+     - Complete Schema.org BreadcrumbList navigation.
+   - **Sharded XML Sitemaps:** Split into 50,000 URL chunks with a master sitemap index to respect Google's crawl budget.
+   - **Dynamic \`/llms.txt\` Feed:** High-density Markdown stream enabling direct indexing by ChatGPT Search & Perplexity.
+
+---
+
+### \uD83D\uDEE0️ 4. AI AGENT IMPLEMENTATION PROTOCOL (STEP-BY-STEP)
+
+When setting up programmatic SEO in any codebase, the AI Agent MUST generate these exact 4 files:
+
+#### File 1: Configuration & Dataset (\`lib/seo.ts\`)
+\`\`\`typescript
+import { PseoMatrixEngine } from "@lynxflow/seo-engine";
+
+export const matrixEngine = new PseoMatrixEngine();
+
+export const SEO_CONFIG = {
+  brandName: "Acme",
+  language: "en",
+  minPopulationToIndex: 15_000,
+};
+
+// Discovered EXCLUSIVELY from Frontend UI components
+export const PSEO_DATASET = {
+  services: [
+    // 1 per major frontend feature branch
+    { slug: "crm-pipeline", name: "Visual CRM Pipeline", category: "Sales", keyFeatures: ["Kanban", "Lead scoring"], description: "Visual deal tracking" },
+  ],
+  targets: [
+    { slug: "law-firms", name: "Law Firms", type: "industry", painPoints: ["Billing"], benefits: ["Compliance"] },
+  ],
+  integrations: [
+    { slug: "shopify", name: "Shopify", category: "E-Commerce", syncFeatures: ["Order sync"] },
+  ],
+  templates: [
+    { slug: "sales-tracker-excel", title: "Sales Tracker", topic: "Sales", format: "excel", benefits: ["Instant setup"] },
+  ],
+  glossaryTerms: [
+    { slug: "mrr", term: "MRR", shortDefinition: "Monthly Recurring Revenue" },
+  ],
+};
+\`\`\`
+
+#### File 2: Universal Dynamic Catch-All Route (\`app/[...slug]/page.tsx\`)
+\`\`\`tsx
+import { notFound } from "next/navigation";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function generateMetadata({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) return {};
+  return { title: page.title, description: page.description, alternates: { canonical: page.canonicalUrl }, robots: page.robots };
+}
+
+export default async function ProgrammaticPage({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) notFound();
+
+  return (
+    <article className="max-w-4xl mx-auto py-12 px-6">
+      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
+      <h1 className="text-4xl font-extrabold">{page.h1}</h1>
+      <p className="mt-4 text-xl text-gray-600">{page.description}</p>
+      {page.disclaimerText && <aside className="mt-8 p-4 bg-gray-50 border rounded text-xs text-gray-500">{page.disclaimerText}</aside>}
+    </article>
+  );
+}
+\`\`\`
+
+#### File 3: Dynamic XML Sitemap (\`app/sitemap.ts\`)
+\`\`\`typescript
+import { MetadataRoute } from "next";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  return pages.filter((p) => p.robots.includes("index")).map((p) => ({
+    url: p.canonicalUrl,
+    lastModified: new Date(),
+    changeFrequency: "weekly",
+    priority: 0.8,
+  }));
+}
+\`\`\`
+
+#### File 4: Dynamic AI Search Markdown Feed (\`app/llms.txt/route.ts\`)
+\`\`\`typescript
+import { NextResponse } from "next/server";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function GET() {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const markdown = [
+    \`# \${SEO_CONFIG.brandName} Solutions Index\`,
+    \`> Structured knowledge feed for LLMs and AI search engines (ChatGPT, Perplexity).\`,
+    \`\`,
+    \`## Solutions & Matrices\`,
+    ...pages.map((p) => \`- [\${p.h1}](\${p.canonicalUrl}): \${p.description}\`),
+  ].join("\\n");
+  return new NextResponse(markdown, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+}
+\`\`\`
+
+---
+
+### \uD83C\uDFDB️ 5. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
 
 1. **10 Canonical Root Pillars:**
    - Comparisons: \`/vs/{competitor}\`
@@ -3691,7 +3821,7 @@ When discovering or listing product modules, features, or services to build the
 
 ---
 
-### \uD83E\uDDF9 4. URL SLUG INTEGRITY & SCHEMA.ORG
+### \uD83E\uDDF9 6. URL SLUG INTEGRITY & SCHEMA.ORG
 
 - Use \`cleanSeoSlug(text, { language })\` to strip accents, dates, and stop words.
 - Use \`ExtendedSchemaGraphBuilder\` to output valid JSON-LD graphs (\`SoftwareApplication\`, \`LocalBusiness\`, \`HowTo\`, \`FAQPage\`, \`BreadcrumbList\`, \`Organization\`).

package/dist/index.mjs

@@ -3551,10 +3551,10 @@ When discovering or listing product modules, features, or services to build the
   - DO NOT create programmatic pages for internal plumbing like: \`/api/stripe\`, \`/api/resend\`, \`/api/auth\`, \`/api/d1\`, \`/api/webhooks\`, \`/api/openai\`.
   - DO NOT expose internal infrastructure, vendors, or suppliers (e.g. Stripe, Resend, Cloudflare D1, Better-Auth, Supabase, PostgreSQL drivers) as public product features. End users never search for or buy your internal backend plumbing.
 - **✅ ALWAYS inspect the FRONTEND user-facing interface & commercial value propositions:**
-  - Read marketing navigation menus & dropdowns (\`components/Navbar.tsx\`, \`components/Header.tsx\`, \`components/Navigation.tsx\`).
-  - Read marketing feature pages & pricing tiers (\`app/(marketing)/*\`, \`pages/features/*\`, \`app/pricing/*\`).
-  - Read dashboard UI workflows & user modules (\`components/dashboard/*\`, \`components/sidebar/*\`).
-  - Identify the actual **benefits and tools the end-user buys** (e.g. "Visual Pipeline Kanban", "Automated Invoice Tracking", "Electronic Signature", "Real-Time Client Portal", "Custom Reporting").
+  - **Step 1A - Marketing Navbars & Dropdowns:** Scan \`components/Navbar.tsx\`, \`components/Header.tsx\`, \`components/Navigation.tsx\` to list all primary product modules.
+  - **Step 1B - Marketing Feature Pages & Pricing:** Scan \`app/(marketing)/*\`, \`pages/features/*\`, \`app/pricing/*\` to list commercial feature names and pricing tiers.
+  - **Step 1C - Dashboard Navigation & User Tools:** Scan \`components/dashboard/*\`, \`components/sidebar/*\` to find actual user workflows.
+  - **Step 1D - Extraction Requirement:** For EACH discovered module (or major product branch), create at least 1 programmatic service entry with \`slug\`, \`name\`, \`category\`, \`description\`, \`keyFeatures\`, and \`priceMonthly\`.
 
 ---
 
@@ -3568,7 +3568,137 @@ When discovering or listing product modules, features, or services to build the
 
 ---
 
-### \uD83C\uDFDB️ 3. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
+### \uD83C\uDFC6 3. THE ARCHITECTURAL PLAYBOOK OF SAAS TITANS (7M+ PAGES WITH 0 DB BOTTLENECKS)
+
+How category leaders generate millions of high-converting pages without server saturation:
+
+1. **Proven Formulas of SaaS Giants:**
+   - ⚡ **Zapier (~25 Million pages):** \`App A × App B\` (e.g. "Connect WhatsApp to Shopify", "Sync Sheets with Notion").
+   - \uD83C\uDFA8 **Canva (~50 Million pages):** \`Template Type × Industry/Theme × Format × Locale\` (e.g. "Restaurant Menu Italian A4").
+   - \uD83D\uDCB8 **Wise (~15 Million pages):** \`Currency Pair × Country × Dynamic Rate Calculator\`.
+   - \uD83D\uDCCA **G2 & Capterra (~10 Million pages):** \`App A vs App B\` / \`Alternative to App X for [Role]\`.
+
+2. **The 4 Pillars of Zero-Latency (< 0.05ms) Resolution:**
+   - **0 Bytes in Database:** Never generate physical static files or query heavy databases per request. Pages are resolved mathematically in RAM upon arrival.
+   - **1 Single Universal Catch-All Route:** \`app/[...slug]/page.tsx\` (or \`app/[locale]/[...slug]/page.tsx\`) handles all matrices through one lightweight layout.
+   - **Edge Caching & ISR:** The rendered HTML is instantly cached at the CDN/Edge (Cloudflare / Vercel Edge) on first request.
+   - **Automatic Siloing & Mesh Linking:**
+     - Links to 3 neighboring geographic cities for the same service.
+     - Links to 4 related professions/industries in the same target category.
+     - Complete Schema.org BreadcrumbList navigation.
+   - **Sharded XML Sitemaps:** Split into 50,000 URL chunks with a master sitemap index to respect Google's crawl budget.
+   - **Dynamic \`/llms.txt\` Feed:** High-density Markdown stream enabling direct indexing by ChatGPT Search & Perplexity.
+
+---
+
+### \uD83D\uDEE0️ 4. AI AGENT IMPLEMENTATION PROTOCOL (STEP-BY-STEP)
+
+When setting up programmatic SEO in any codebase, the AI Agent MUST generate these exact 4 files:
+
+#### File 1: Configuration & Dataset (\`lib/seo.ts\`)
+\`\`\`typescript
+import { PseoMatrixEngine } from "@lynxflow/seo-engine";
+
+export const matrixEngine = new PseoMatrixEngine();
+
+export const SEO_CONFIG = {
+  brandName: "Acme",
+  language: "en",
+  minPopulationToIndex: 15_000,
+};
+
+// Discovered EXCLUSIVELY from Frontend UI components
+export const PSEO_DATASET = {
+  services: [
+    // 1 per major frontend feature branch
+    { slug: "crm-pipeline", name: "Visual CRM Pipeline", category: "Sales", keyFeatures: ["Kanban", "Lead scoring"], description: "Visual deal tracking" },
+  ],
+  targets: [
+    { slug: "law-firms", name: "Law Firms", type: "industry", painPoints: ["Billing"], benefits: ["Compliance"] },
+  ],
+  integrations: [
+    { slug: "shopify", name: "Shopify", category: "E-Commerce", syncFeatures: ["Order sync"] },
+  ],
+  templates: [
+    { slug: "sales-tracker-excel", title: "Sales Tracker", topic: "Sales", format: "excel", benefits: ["Instant setup"] },
+  ],
+  glossaryTerms: [
+    { slug: "mrr", term: "MRR", shortDefinition: "Monthly Recurring Revenue" },
+  ],
+};
+\`\`\`
+
+#### File 2: Universal Dynamic Catch-All Route (\`app/[...slug]/page.tsx\`)
+\`\`\`tsx
+import { notFound } from "next/navigation";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function generateMetadata({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) return {};
+  return { title: page.title, description: page.description, alternates: { canonical: page.canonicalUrl }, robots: page.robots };
+}
+
+export default async function ProgrammaticPage({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) notFound();
+
+  return (
+    <article className="max-w-4xl mx-auto py-12 px-6">
+      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
+      <h1 className="text-4xl font-extrabold">{page.h1}</h1>
+      <p className="mt-4 text-xl text-gray-600">{page.description}</p>
+      {page.disclaimerText && <aside className="mt-8 p-4 bg-gray-50 border rounded text-xs text-gray-500">{page.disclaimerText}</aside>}
+    </article>
+  );
+}
+\`\`\`
+
+#### File 3: Dynamic XML Sitemap (\`app/sitemap.ts\`)
+\`\`\`typescript
+import { MetadataRoute } from "next";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  return pages.filter((p) => p.robots.includes("index")).map((p) => ({
+    url: p.canonicalUrl,
+    lastModified: new Date(),
+    changeFrequency: "weekly",
+    priority: 0.8,
+  }));
+}
+\`\`\`
+
+#### File 4: Dynamic AI Search Markdown Feed (\`app/llms.txt/route.ts\`)
+\`\`\`typescript
+import { NextResponse } from "next/server";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function GET() {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const markdown = [
+    \`# \${SEO_CONFIG.brandName} Solutions Index\`,
+    \`> Structured knowledge feed for LLMs and AI search engines (ChatGPT, Perplexity).\`,
+    \`\`,
+    \`## Solutions & Matrices\`,
+    ...pages.map((p) => \`- [\${p.h1}](\${p.canonicalUrl}): \${p.description}\`),
+  ].join("\\n");
+  return new NextResponse(markdown, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+}
+\`\`\`
+
+---
+
+### \uD83C\uDFDB️ 5. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
 
 1. **10 Canonical Root Pillars:**
    - Comparisons: \`/vs/{competitor}\`
@@ -3593,7 +3723,7 @@ When discovering or listing product modules, features, or services to build the
 
 ---
 
-### \uD83E\uDDF9 4. URL SLUG INTEGRITY & SCHEMA.ORG
+### \uD83E\uDDF9 6. URL SLUG INTEGRITY & SCHEMA.ORG
 
 - Use \`cleanSeoSlug(text, { language })\` to strip accents, dates, and stop words.
 - Use \`ExtendedSchemaGraphBuilder\` to output valid JSON-LD graphs (\`SoftwareApplication\`, \`LocalBusiness\`, \`HowTo\`, \`FAQPage\`, \`BreadcrumbList\`, \`Organization\`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxflow/seo-engine",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "description": "High-Performance Multilingual Programmatic SEO & AI Search Engine SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/llm-prompt.ts

@@ -17,10 +17,10 @@ When discovering or listing product modules, features, or services to build the
   - DO NOT create programmatic pages for internal plumbing like: \`/api/stripe\`, \`/api/resend\`, \`/api/auth\`, \`/api/d1\`, \`/api/webhooks\`, \`/api/openai\`.
   - DO NOT expose internal infrastructure, vendors, or suppliers (e.g. Stripe, Resend, Cloudflare D1, Better-Auth, Supabase, PostgreSQL drivers) as public product features. End users never search for or buy your internal backend plumbing.
 - **✅ ALWAYS inspect the FRONTEND user-facing interface & commercial value propositions:**
-  - Read marketing navigation menus & dropdowns (\`components/Navbar.tsx\`, \`components/Header.tsx\`, \`components/Navigation.tsx\`).
-  - Read marketing feature pages & pricing tiers (\`app/(marketing)/*\`, \`pages/features/*\`, \`app/pricing/*\`).
-  - Read dashboard UI workflows & user modules (\`components/dashboard/*\`, \`components/sidebar/*\`).
-  - Identify the actual **benefits and tools the end-user buys** (e.g. "Visual Pipeline Kanban", "Automated Invoice Tracking", "Electronic Signature", "Real-Time Client Portal", "Custom Reporting").
+  - **Step 1A - Marketing Navbars & Dropdowns:** Scan \`components/Navbar.tsx\`, \`components/Header.tsx\`, \`components/Navigation.tsx\` to list all primary product modules.
+  - **Step 1B - Marketing Feature Pages & Pricing:** Scan \`app/(marketing)/*\`, \`pages/features/*\`, \`app/pricing/*\` to list commercial feature names and pricing tiers.
+  - **Step 1C - Dashboard Navigation & User Tools:** Scan \`components/dashboard/*\`, \`components/sidebar/*\` to find actual user workflows.
+  - **Step 1D - Extraction Requirement:** For EACH discovered module (or major product branch), create at least 1 programmatic service entry with \`slug\`, \`name\`, \`category\`, \`description\`, \`keyFeatures\`, and \`priceMonthly\`.
 
 ---
 
@@ -34,7 +34,137 @@ When discovering or listing product modules, features, or services to build the
 
 ---
 
-### 🏛️ 3. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
+### 🏆 3. THE ARCHITECTURAL PLAYBOOK OF SAAS TITANS (7M+ PAGES WITH 0 DB BOTTLENECKS)
+
+How category leaders generate millions of high-converting pages without server saturation:
+
+1. **Proven Formulas of SaaS Giants:**
+   - ⚡ **Zapier (~25 Million pages):** \`App A × App B\` (e.g. "Connect WhatsApp to Shopify", "Sync Sheets with Notion").
+   - 🎨 **Canva (~50 Million pages):** \`Template Type × Industry/Theme × Format × Locale\` (e.g. "Restaurant Menu Italian A4").
+   - 💸 **Wise (~15 Million pages):** \`Currency Pair × Country × Dynamic Rate Calculator\`.
+   - 📊 **G2 & Capterra (~10 Million pages):** \`App A vs App B\` / \`Alternative to App X for [Role]\`.
+
+2. **The 4 Pillars of Zero-Latency (< 0.05ms) Resolution:**
+   - **0 Bytes in Database:** Never generate physical static files or query heavy databases per request. Pages are resolved mathematically in RAM upon arrival.
+   - **1 Single Universal Catch-All Route:** \`app/[...slug]/page.tsx\` (or \`app/[locale]/[...slug]/page.tsx\`) handles all matrices through one lightweight layout.
+   - **Edge Caching & ISR:** The rendered HTML is instantly cached at the CDN/Edge (Cloudflare / Vercel Edge) on first request.
+   - **Automatic Siloing & Mesh Linking:**
+     - Links to 3 neighboring geographic cities for the same service.
+     - Links to 4 related professions/industries in the same target category.
+     - Complete Schema.org BreadcrumbList navigation.
+   - **Sharded XML Sitemaps:** Split into 50,000 URL chunks with a master sitemap index to respect Google's crawl budget.
+   - **Dynamic \`/llms.txt\` Feed:** High-density Markdown stream enabling direct indexing by ChatGPT Search & Perplexity.
+
+---
+
+### 🛠️ 4. AI AGENT IMPLEMENTATION PROTOCOL (STEP-BY-STEP)
+
+When setting up programmatic SEO in any codebase, the AI Agent MUST generate these exact 4 files:
+
+#### File 1: Configuration & Dataset (\`lib/seo.ts\`)
+\`\`\`typescript
+import { PseoMatrixEngine } from "@lynxflow/seo-engine";
+
+export const matrixEngine = new PseoMatrixEngine();
+
+export const SEO_CONFIG = {
+  brandName: "Acme",
+  language: "en",
+  minPopulationToIndex: 15_000,
+};
+
+// Discovered EXCLUSIVELY from Frontend UI components
+export const PSEO_DATASET = {
+  services: [
+    // 1 per major frontend feature branch
+    { slug: "crm-pipeline", name: "Visual CRM Pipeline", category: "Sales", keyFeatures: ["Kanban", "Lead scoring"], description: "Visual deal tracking" },
+  ],
+  targets: [
+    { slug: "law-firms", name: "Law Firms", type: "industry", painPoints: ["Billing"], benefits: ["Compliance"] },
+  ],
+  integrations: [
+    { slug: "shopify", name: "Shopify", category: "E-Commerce", syncFeatures: ["Order sync"] },
+  ],
+  templates: [
+    { slug: "sales-tracker-excel", title: "Sales Tracker", topic: "Sales", format: "excel", benefits: ["Instant setup"] },
+  ],
+  glossaryTerms: [
+    { slug: "mrr", term: "MRR", shortDefinition: "Monthly Recurring Revenue" },
+  ],
+};
+\`\`\`
+
+#### File 2: Universal Dynamic Catch-All Route (\`app/[...slug]/page.tsx\`)
+\`\`\`tsx
+import { notFound } from "next/navigation";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function generateMetadata({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) return {};
+  return { title: page.title, description: page.description, alternates: { canonical: page.canonicalUrl }, robots: page.robots };
+}
+
+export default async function ProgrammaticPage({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) notFound();
+
+  return (
+    <article className="max-w-4xl mx-auto py-12 px-6">
+      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
+      <h1 className="text-4xl font-extrabold">{page.h1}</h1>
+      <p className="mt-4 text-xl text-gray-600">{page.description}</p>
+      {page.disclaimerText && <aside className="mt-8 p-4 bg-gray-50 border rounded text-xs text-gray-500">{page.disclaimerText}</aside>}
+    </article>
+  );
+}
+\`\`\`
+
+#### File 3: Dynamic XML Sitemap (\`app/sitemap.ts\`)
+\`\`\`typescript
+import { MetadataRoute } from "next";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  return pages.filter((p) => p.robots.includes("index")).map((p) => ({
+    url: p.canonicalUrl,
+    lastModified: new Date(),
+    changeFrequency: "weekly",
+    priority: 0.8,
+  }));
+}
+\`\`\`
+
+#### File 4: Dynamic AI Search Markdown Feed (\`app/llms.txt/route.ts\`)
+\`\`\`typescript
+import { NextResponse } from "next/server";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function GET() {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const markdown = [
+    \`# \${SEO_CONFIG.brandName} Solutions Index\`,
+    \`> Structured knowledge feed for LLMs and AI search engines (ChatGPT, Perplexity).\`,
+    \`\`,
+    \`## Solutions & Matrices\`,
+    ...pages.map((p) => \`- [\${p.h1}](\${p.canonicalUrl}): \${p.description}\`),
+  ].join("\\n");
+  return new NextResponse(markdown, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+}
+\`\`\`
+
+---
+
+### 🏛️ 5. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
 
 1. **10 Canonical Root Pillars:**
    - Comparisons: \`/vs/{competitor}\`
@@ -59,7 +189,7 @@ When discovering or listing product modules, features, or services to build the
 
 ---
 
-### 🧹 4. URL SLUG INTEGRITY & SCHEMA.ORG
+### 🧹 6. URL SLUG INTEGRITY & SCHEMA.ORG
 
 - Use \`cleanSeoSlug(text, { language })\` to strip accents, dates, and stop words.
 - Use \`ExtendedSchemaGraphBuilder\` to output valid JSON-LD graphs (\`SoftwareApplication\`, \`LocalBusiness\`, \`HowTo\`, \`FAQPage\`, \`BreadcrumbList\`, \`Organization\`).