saglitzdesign-mcp 0.3.1

package/knowledge/examples/web.json

@@ -0,0 +1,321 @@
+[
+  {
+    "id": "web-hero-clickup",
+    "title": "ClickUp — hero with inline email capture and product preview",
+    "platform": "web",
+    "app": "ClickUp",
+    "pattern": "hero",
+    "description": "Bold black headline ('Manage operations like a boss') paired with an inline work-email field and a purple Get Started button, with 'Free forever, no credit card' friction-reducers right beside the CTA. A floating product screenshot with a play button sits on a sweeping purple gradient blob, and a logo strip ('Join 800,000+ teams' with Samsung, IBM, Booking.com) anchors the fold with social proof.",
+    "tags": ["hero", "landing", "cta", "email-capture", "signup", "screenshot", "social-proof", "gradient"],
+    "mobbin_url": "https://mobbin.com/sites/sections/8327bdfc-5c9d-4240-b4af-9431eebd0f9e",
+    "image": "images/web-hero-clickup.jpg"
+  },
+  {
+    "id": "web-hero-framer",
+    "title": "Framer — dark hero framed inside the product editor",
+    "platform": "web",
+    "app": "Framer",
+    "pattern": "hero",
+    "description": "Shows the marketing site rendered inside Framer's own editor chrome, so the hero doubles as a product demo. Deep purple-on-black gradient scene, centered white headline with an emotional hook, and a single high-contrast purple 'Sign up - it's free' pill button. Great example of a dark, immersive hero where the product is the visual.",
+    "tags": ["hero", "dark", "cta", "signup", "gradient", "screenshot", "landing"],
+    "mobbin_url": "https://mobbin.com/sites/sections/6b15ed49-32d7-4761-b7f8-fefed2414fde",
+    "image": "images/web-hero-framer.jpg"
+  },
+  {
+    "id": "web-hero-passionfroot",
+    "title": "Passionfroot — warm minimal hero with floating UI fragments",
+    "platform": "web",
+    "app": "Passionfroot",
+    "pattern": "hero",
+    "description": "Large serif headline ('Where creators do brand deals') centered on a warm cream background, one short subline, and a single black 'Start for Free' pill. Product-UI fragments (payment card, calendar, charts) float in from the edges at low contrast, hinting at the product without competing with the copy. Excellent restraint and hierarchy.",
+    "tags": ["hero", "minimal", "cta", "serif", "landing", "light", "screenshot"],
+    "mobbin_url": "https://mobbin.com/sites/sections/d008689a-c73f-4513-a760-25a93ef6f043",
+    "image": "images/web-hero-passionfroot.jpg"
+  },
+  {
+    "id": "web-hero-mural",
+    "title": "Mural — playful oversized CTA hero",
+    "platform": "web",
+    "app": "Mural",
+    "pattern": "hero",
+    "description": "A vivid pink section where the CTA itself is the hero: a giant yellow sticky-note-shaped button reading 'Get started' in a large serif, echoing the product's whiteboard sticky notes. Tiny supporting line above and a persistent 'Sign up, free forever' button in the nav. Memorable, brand-forward take on a conversion section.",
+    "tags": ["hero", "cta", "playful", "colorful", "signup", "brand", "landing"],
+    "mobbin_url": "https://mobbin.com/sites/sections/edb14076-5e1f-48d8-ba26-5e5e43f9a9b0",
+    "image": "images/web-hero-mural.jpg"
+  },
+  {
+    "id": "web-pricing-webflow",
+    "title": "Webflow — two-plan pricing with benefit checklist",
+    "platform": "web",
+    "app": "Webflow",
+    "pattern": "pricing",
+    "description": "Split layout: left column carries the headline and three checkmarked benefits, right side shows two compact plan cards (Freelancer $16, Agency $35) with per-seat pricing and short feature lists. The recommended plan gets a solid purple fill while the other stays light, making the preferred choice obvious at a glance.",
+    "tags": ["pricing", "plans", "cards", "comparison", "saas", "checklist", "cta"],
+    "mobbin_url": "https://mobbin.com/sites/sections/5f39c974-75c8-4ea0-abdb-b9bdaa05596d",
+    "image": "images/web-pricing-webflow.jpg"
+  },
+  {
+    "id": "web-pricing-elevenlabs",
+    "title": "ElevenLabs — six-tier plan comparison table",
+    "platform": "web",
+    "app": "ElevenLabs",
+    "pattern": "pricing",
+    "description": "A dense 'Compare our plans' matrix across six tiers (Free to Business), grouped by capability sections like Credits and Text to Speech. Each column gets its own 'Get started' button with the popular tier inverted in black; green checks and gray crosses keep row scanning fast. Strong reference for detailed feature-comparison pricing.",
+    "tags": ["pricing", "comparison", "table", "tiers", "saas", "matrix", "cta"],
+    "mobbin_url": "https://mobbin.com/sites/sections/ed1a4962-9ba3-4765-9ec1-134cac2a9d2e",
+    "image": "images/web-pricing-elevenlabs.jpg"
+  },
+  {
+    "id": "web-pricing-apollo",
+    "title": "Apollo — compare-plans table with 'most popular' highlight",
+    "platform": "web",
+    "app": "Apollo",
+    "pattern": "pricing",
+    "description": "Four-column comparison ($0 to $119/user) with credit allotments under each price and yellow CTA buttons, the Professional tier flagged with a 'Most Popular' badge and a black button. Features are grouped into collapsible category rows (Outbound, Inbound) with icons, keeping a long matrix scannable.",
+    "tags": ["pricing", "comparison", "table", "plans", "badge", "saas", "collapsible"],
+    "mobbin_url": "https://mobbin.com/sites/sections/04450619-1e0b-41af-bb83-dc67a4fca119",
+    "image": "images/web-pricing-apollo.jpg"
+  },
+  {
+    "id": "web-pricing-maze",
+    "title": "Maze — editorial pricing cards on warm neutral background",
+    "platform": "web",
+    "app": "Maze",
+    "pattern": "pricing",
+    "description": "Pricing as an asymmetric card grid: Free and Starter stacked on the left with price badges ('$99 per month') in the card corner, Enterprise given a larger card with a lime graphic accent and a long 'Enterprise includes' list. Serif-flavored headings and generous whitespace make a normally dry section feel designed.",
+    "tags": ["pricing", "cards", "plans", "enterprise", "minimal", "editorial", "saas"],
+    "mobbin_url": "https://mobbin.com/sites/sections/3227e1e7-10d9-4ac3-bf5d-b7ba286afa33",
+    "image": "images/web-pricing-maze.jpg"
+  },
+  {
+    "id": "web-features-square",
+    "title": "Square — alternating feature rows with photography",
+    "platform": "web",
+    "app": "Square",
+    "pattern": "features",
+    "description": "Four stacked feature rows, each pairing a small real-world photo of the product in use with a bold benefit heading, two lines of copy, and a 'Learn more' link, separated by hairline rules. Extremely scannable rhythm that grounds software features in physical retail contexts.",
+    "tags": ["features", "list", "photography", "benefits", "rows", "minimal", "learn-more"],
+    "mobbin_url": "https://mobbin.com/sites/sections/54ba196c-c979-4564-a54a-c02a23e8e8f7",
+    "image": "images/web-features-square.jpg"
+  },
+  {
+    "id": "web-features-fibery",
+    "title": "Fibery — icon grid of secondary features",
+    "platform": "web",
+    "app": "Fibery",
+    "pattern": "features",
+    "description": "A 4-column grid of 16 lightweight feature entries, each just a small colorful icon and a short label (Map view, Forms, Whiteboards, Automation Rules). Shows how to compress a long capability list into a dense, skimmable grid without screenshots, with a 'new' badge for fresh items.",
+    "tags": ["features", "grid", "icons", "bento", "capabilities", "compact", "saas"],
+    "mobbin_url": "https://mobbin.com/sites/sections/3f148051-6eff-401c-bc33-113cc1d2e964",
+    "image": "images/web-features-fibery.jpg"
+  },
+  {
+    "id": "web-features-mural",
+    "title": "Mural — product screenshot gallery grid",
+    "platform": "web",
+    "app": "Mural",
+    "pattern": "features",
+    "description": "A 2-up grid of framed product screenshots on saturated pink/purple panels, each captioned (blank board, sticky-note session) with a download link. Demonstrates presenting product UI states as a bold, color-blocked gallery rather than isolated floating screenshots.",
+    "tags": ["features", "screenshots", "grid", "gallery", "colorful", "product", "bento"],
+    "mobbin_url": "https://mobbin.com/sites/sections/2f012efb-ee2c-4087-8a5a-04b88d103f20",
+    "image": "images/web-features-mural.jpg"
+  },
+  {
+    "id": "web-social-proof-tines",
+    "title": "Tines — objection-handling proof wall with customer stats",
+    "platform": "web",
+    "app": "Tines",
+    "pattern": "social-proof",
+    "description": "Leads with the skeptic's voice ('Sounds... hard to believe?') on a card that cites 200+ G2 reviews at 4.8 stars, then backs it with a mosaic of stat and quote cards from named enterprise logos (Elastic, Snowflake, Mars, Intercom) — '50% reduction in time per ticket', '10 hours saved every day'. Quantified proof beats generic praise.",
+    "tags": ["social-proof", "testimonials", "stats", "logos", "g2", "reviews", "bento", "enterprise"],
+    "mobbin_url": "https://mobbin.com/sites/sections/58a55724-34ad-4dc5-accb-743f3b00cd68",
+    "image": "images/web-social-proof-tines.jpg"
+  },
+  {
+    "id": "web-social-proof-mixpanel",
+    "title": "Mixpanel — testimonial marquee mixing tweets and NPS quotes",
+    "platform": "web",
+    "app": "Mixpanel",
+    "pattern": "social-proof",
+    "description": "Dark purple gradient section with a large headline over two horizontal rows of testimonial cards: named Twitter posts with avatars on top, anonymous NPS-survey quotes below. The overflowing carded rows imply volume of praise, and mixing attributed tweets with NPS verbatims adds credibility range.",
+    "tags": ["social-proof", "testimonials", "tweets", "nps", "dark", "carousel", "cards"],
+    "mobbin_url": "https://mobbin.com/sites/sections/02e3c65c-ed1d-42b0-9439-4c285f360e44",
+    "image": "images/web-social-proof-mixpanel.jpg"
+  },
+  {
+    "id": "web-social-proof-klarna",
+    "title": "Klarna — Trustpilot rating with rotating review cards",
+    "platform": "web",
+    "app": "Klarna",
+    "pattern": "social-proof",
+    "description": "Left column stacks a Trustpilot widget (4.0, 370,674 reviews), a 'Shoppers love Klarna' headline, and a 100M+ users claim; right side shows two large star-rated quote cards in brand purple/dark tones with arrow controls to page through more. Third-party rating plus first-person quotes in one tight band, with a small honesty disclaimer.",
+    "tags": ["social-proof", "testimonials", "trustpilot", "reviews", "ratings", "carousel", "fintech"],
+    "mobbin_url": "https://mobbin.com/sites/sections/1a0904da-e870-48b5-bd03-18e75cbb8de3",
+    "image": "images/web-social-proof-klarna.jpg"
+  },
+  {
+    "id": "web-social-proof-sproutsocial",
+    "title": "Sprout Social — G2 review cards with star ratings and titles",
+    "platform": "web",
+    "app": "Sprout Social",
+    "pattern": "social-proof",
+    "description": "Three equal review cards under a plain 'What our customers say about us' heading, each with a quoted review title, star rating, excerpt, 'Read more' link, and an avatar with the reviewer's name and job title; a G2 logo sits in the corner to source the reviews. The canonical, safe testimonial-card pattern executed cleanly.",
+    "tags": ["social-proof", "testimonials", "reviews", "g2", "cards", "stars", "avatars"],
+    "mobbin_url": "https://mobbin.com/sites/sections/15b459ef-ab1a-4648-8f36-940ab45d4731",
+    "image": "images/web-social-proof-sproutsocial.jpg"
+  },
+  {
+    "id": "web-landing-june",
+    "title": "June — centered SaaS landing with two-tone headline",
+    "platform": "web",
+    "app": "June",
+    "pattern": "landing",
+    "description": "Classic centered SaaS hero: announcement banner up top, simple nav, huge two-tone headline ('A new way to do product analytics' with the key phrase in purple), one-sentence subcopy, a single 'Get started for free' button, and the dashboard screenshot rising from the fold. A hand-drawn annotation ('Auto-generated reports') points into the screenshot for personality.",
+    "tags": ["landing", "hero", "saas", "cta", "screenshot", "centered", "analytics", "banner"],
+    "mobbin_url": "https://mobbin.com/screens/b0590443-627a-4533-934a-5ebcf03534a5",
+    "image": "images/web-landing-june.jpg"
+  },
+  {
+    "id": "web-landing-productboard",
+    "title": "Productboard — landing hero with UI-fragment collage",
+    "platform": "web",
+    "app": "Productboard",
+    "pattern": "landing",
+    "description": "Centered headline with the value phrase highlighted in blue, dual CTAs ('Get started' primary, 'Request demo' secondary), and an announcement pill above the nav. Below the fold, the product appears as a collage of cropped UI cards — roadmap, charts, a customer quote — rather than one monolithic screenshot, conveying breadth of features.",
+    "tags": ["landing", "hero", "saas", "cta", "screenshot", "collage", "demo", "roadmap"],
+    "mobbin_url": "https://mobbin.com/screens/9dae958f-c1a5-4b8f-9409-875008fd9b71",
+    "image": "images/web-landing-productboard.jpg"
+  },
+  {
+    "id": "web-landing-stackai",
+    "title": "StackAI — monochrome enterprise AI landing",
+    "platform": "web",
+    "app": "StackAI",
+    "pattern": "landing",
+    "description": "Near-monochrome landing: oversized serif-ish headline ('From process to AI agent, in minutes'), two muted lines of enterprise positioning, then paired CTAs with the sales-led action ('Get a Demo') in solid black and 'Try It Now' in gray. A large workflow-canvas screenshot in a device frame fills the lower half. Quiet, credible enterprise tone.",
+    "tags": ["landing", "hero", "enterprise", "ai", "minimal", "cta", "screenshot", "monochrome"],
+    "mobbin_url": "https://mobbin.com/screens/00877e31-4b84-477f-844f-000bb4b4405e",
+    "image": "images/web-landing-stackai.jpg"
+  },
+  {
+    "id": "web-signup-ghost",
+    "title": "Ghost — single-column create-account form",
+    "platform": "web",
+    "app": "Ghost",
+    "pattern": "signup",
+    "description": "Chromeless signup: just a centered logo, a bold 'Create your account.' heading, three labeled fields (full name, email, password), and one full-width muted-rose 'Create Account' button on a soft gradient background. Zero navigation or distractions — the minimal signup archetype.",
+    "tags": ["signup", "form", "minimal", "onboarding", "account", "single-column", "cta"],
+    "mobbin_url": "https://mobbin.com/screens/da622210-897c-40c7-a1fd-ffc5314b9e8f",
+    "image": "images/web-signup-ghost.jpg"
+  },
+  {
+    "id": "web-signup-hodinkee",
+    "title": "HODINKEE — editorial-brand signup with stacked fields",
+    "platform": "web",
+    "app": "HODINKEE",
+    "pattern": "signup",
+    "description": "Serif 'Sign up' heading over five stacked placeholder-labeled fields and a full-width black uppercase button, keeping the brand's editorial typography even in a utility flow. Inline password requirement hint below the field and legal/reCAPTCHA fine print under the button show how to handle compliance copy without clutter.",
+    "tags": ["signup", "form", "editorial", "serif", "account", "validation", "legal"],
+    "mobbin_url": "https://mobbin.com/screens/51be05c9-eae8-4e46-9bb1-1de560a6fad1",
+    "image": "images/web-signup-hodinkee.jpg"
+  },
+  {
+    "id": "web-signup-wayyy",
+    "title": "Wayyy — compact signup with side-by-side name fields",
+    "platform": "web",
+    "app": "Wayyy",
+    "pattern": "signup",
+    "description": "Tight centered form: logo mark, small 'Sign up' label, first/last name paired on one row, email and password stacked, a terms checkbox with linked policy, a full-width blue 'Create Account' button, and a 'Already have an account? Login' escape hatch. Textbook field grouping and visual order for a minimal-friction signup.",
+    "tags": ["signup", "form", "minimal", "checkbox", "terms", "account", "onboarding"],
+    "mobbin_url": "https://mobbin.com/screens/d9403e16-63af-4faf-ad50-c64f5324b0d6",
+    "image": "images/web-signup-wayyy.jpg"
+  },
+  {
+    "id": "web-dashboard-felt",
+    "title": "Felt — map workspace dashboard with thumbnail grid",
+    "platform": "web",
+    "app": "Felt",
+    "pattern": "dashboard",
+    "description": "Left sidebar with nav (Recents, Drafts, Settings) and a projects list, main area showing a dismissible onboarding row of video tutorials above a grid of colorful map-thumbnail cards with title, owner, and last-viewed metadata. A trial-countdown card with 'Talk to Sales' CTA sits pinned at the sidebar bottom — good upgrade-nudge placement.",
+    "tags": ["dashboard", "sidebar", "cards", "grid", "thumbnails", "onboarding", "trial", "saas"],
+    "mobbin_url": "https://mobbin.com/screens/79f37f27-f1f0-4d31-96ec-899917cb9aa4",
+    "image": "images/web-dashboard-felt.jpg"
+  },
+  {
+    "id": "web-dashboard-sana-ai",
+    "title": "Sana AI — dark AI-assistant home with suggestion cards",
+    "platform": "web",
+    "app": "Sana AI",
+    "pattern": "dashboard",
+    "description": "Dark workspace with a slim sidebar (Home, Templates, Meetings, Files plus color-coded collections), a personal greeting in two-tone type ('Hello, Jane / How can I help you today?'), a row of suggested-content cards, and a persistent chat/ask input across the bottom. A credits meter at the sidebar foot handles usage limits gracefully.",
+    "tags": ["dashboard", "dark", "sidebar", "ai", "cards", "chat", "greeting", "assistant"],
+    "mobbin_url": "https://mobbin.com/screens/4560f04c-5d7c-4a1c-9316-088ec410a8fb",
+    "image": "images/web-dashboard-sana-ai.jpg"
+  },
+  {
+    "id": "web-dashboard-clickup",
+    "title": "ClickUp — customizable widget dashboard with edit mode",
+    "platform": "web",
+    "app": "ClickUp",
+    "pattern": "dashboard",
+    "description": "Icon-labeled left sidebar (Home, Notifications, Pulse, Goals, Dashboards) beside a widget canvas holding draggable cards — welcome note, chat, docs/links, task list — on a visible layout grid with an 'Edit mode' toggle and '+ Add card' button in the toolbar. A clear reference for user-composable dashboards.",
+    "tags": ["dashboard", "sidebar", "widgets", "cards", "customizable", "grid", "saas"],
+    "mobbin_url": "https://mobbin.com/screens/21aa1ed3-3c0d-4779-a8bc-1fd991aaf0f5",
+    "image": "images/web-dashboard-clickup.jpg"
+  },
+  {
+    "id": "web-dashboard-dovetail",
+    "title": "Dovetail — project board with card grid and context menu",
+    "platform": "web",
+    "app": "Dovetail",
+    "pattern": "dashboard",
+    "description": "Project workspace showing a grid of content cards (video with thumbnail, transcript notes, empty-state cards like '+ New note' and 'Import data') under a top bar with global search and New note CTA. An open sidebar panel demonstrates show/hide toggles for sections (Notes, Tags, Highlights, Insights) — a nice pattern for user-configurable navigation.",
+    "tags": ["dashboard", "sidebar", "cards", "grid", "workspace", "research", "empty-state"],
+    "mobbin_url": "https://mobbin.com/screens/bcbc434d-f7e8-44f4-a17a-a00655f0ca4b",
+    "image": "images/web-dashboard-dovetail.jpg"
+  },
+  {
+    "id": "web-footer-zendesk",
+    "title": "Zendesk — five-column mega footer with newsletter bar",
+    "platform": "web",
+    "app": "Zendesk",
+    "pattern": "footer",
+    "description": "Comprehensive sitemap footer: a brand statement ('Champions of customer service') beside five link columns (Products, Features, Resources, Company, Favorite Things), then a distinct newsletter row — 'Enter the fold' with an email field and solid Subscribe button — plus social icons, legal links, and compliance fine print at the bottom.",
+    "tags": ["footer", "newsletter", "links", "sitemap", "columns", "social", "legal"],
+    "mobbin_url": "https://mobbin.com/sites/sections/2e8bfe6a-f94b-4f8a-84f5-7fd518da9598",
+    "image": "images/web-footer-zendesk.jpg"
+  },
+  {
+    "id": "web-footer-shopify",
+    "title": "Shopify Supply — black footer with signup band and marquee",
+    "platform": "web",
+    "app": "Shopify",
+    "pattern": "footer",
+    "description": "High-contrast black footer opening with a conversion band ('Want more Supply? save 10%') containing a rounded email field with an inline Sign up button, followed by a scrolling 'By merchants, for merchants' marquee ribbon in blue, boxed social icon cells, and a utility row of FAQ/legal links. Footer as brand moment, not just a link dump.",
+    "tags": ["footer", "newsletter", "dark", "email-capture", "marquee", "social", "ecommerce"],
+    "mobbin_url": "https://mobbin.com/sites/sections/091c7a61-be44-4c2d-bafa-fa3afe0da71c",
+    "image": "images/web-footer-shopify.jpg"
+  },
+  {
+    "id": "web-footer-employmenthero",
+    "title": "Employment Hero — footer with consent-checkbox newsletter",
+    "platform": "web",
+    "app": "Employment Hero",
+    "pattern": "footer",
+    "description": "Six link columns (Company, Support, Region picker, Product, Connect with social icons) above a split lower band pairing a mission statement with a newsletter form that includes explicit GDPR-style consent checkboxes before the purple Subscribe button. Also shows region selection and a full legal link row — a compliance-complete footer.",
+    "tags": ["footer", "newsletter", "links", "columns", "consent", "legal", "social"],
+    "mobbin_url": "https://mobbin.com/sites/sections/6efab40e-de5e-4dff-bf1c-b28c818a934d",
+    "image": "images/web-footer-employmenthero.jpg"
+  },
+  {
+    "id": "web-footer-incommonwith",
+    "title": "In Common With — hairline-divided editorial footer",
+    "platform": "web",
+    "app": "In Common With",
+    "pattern": "footer",
+    "description": "Refined studio footer organized by thin vertical hairlines: contact and showroom addresses with hours across the top, link columns (Shop, Info, Account) below, and a quiet newsletter block — 'Our Newsletter' label, underlined email input with an outlined Sign Up button, and a privacy note. Typographic, grid-driven, and calm; ideal for premium or editorial brands.",
+    "tags": ["footer", "newsletter", "editorial", "minimal", "grid", "links", "typography"],
+    "mobbin_url": "https://mobbin.com/sites/sections/f1844604-7696-4970-b30e-43a7669e9ee1",
+    "image": "images/web-footer-incommonwith.jpg"
+  }
+]

package/knowledge/geo/geo-fundamentals.md

@@ -0,0 +1,120 @@
+---
+id: geo-fundamentals
+title: "GEO Fundamentals — Generative Engine Optimization"
+category: geo
+platform: web
+tags: [ai-search, llm, citations, llms-txt, ai-overviews, entity-seo]
+sources: ["https://llmrefs.com/generative-engine-optimization", "https://developers.google.com/search/docs/appearance/ai-features", "https://searchengineland.com/guide/optimize-for-ai-crawlers", "https://llmstxt.org/", "https://www.semrush.com/blog/ai-seo-statistics/", "https://www.lumar.io/blog/best-practice/4-pillar-geo-strategy-framework-for-ai-search-visibility/", "https://www.surmado.com/blog/best-ai-visibility-tools-2026", "https://otterly.ai/blog/best-ai-search-monitoring-and-llm-monitoring-solutions/", "https://www.omnibound.ai/blog/ai-seo-statistics", "https://thestacc.com/blog/google-ai-overview-statistics/"]
+updated: 2026-07-08
+---
+
+# GEO Fundamentals — Generative Engine Optimization (state of 2026)
+
+## 1. What GEO is
+
+**Generative Engine Optimization (GEO)** is the practice of structuring content, sites, and brand presence so that AI answer engines — ChatGPT (with search), Perplexity, Google AI Overviews / AI Mode, Gemini, Claude, and Copilot — **retrieve your content, use it in synthesized answers, and cite or mention your brand**.
+
+The core mental shift:
+
+> **SEO gets you ranked. GEO gets you cited.**
+
+AI engines don't return a ranked list of ten links. They run a retrieval pipeline, synthesize one answer from multiple sources, and attach a handful of citations. If you are not one of those sources — or your brand isn't named in the answer — you are invisible, regardless of your Google rank.
+
+### Why it matters (2026 numbers)
+
+- ~48% of Google queries now trigger AI Overviews (up 58% YoY); coverage is highest in healthcare (~88%), education (~83%), and B2B tech (~82%).
+- 93% of Google AI Mode sessions and ~83% of AI Overview searches end **without a click** (Semrush).
+- AI Overviews cut organic CTR for position 1 by up to 58% (Ahrefs); Seer Interactive measured organic CTR falling from 1.76% to 0.61% on AIO queries.
+- BUT: AI-referred visitors convert at **~4.4x** the rate of traditional organic visitors (Semrush), and AI referral traffic grew ~527% YoY. ChatGPT drives ~56% of AI referral traffic, Gemini ~18%, Perplexity ~8% (Otterly).
+- Brands cited inside AI Overviews see ~35% organic CTR uplift on the same SERP versus non-cited brands.
+
+Net effect: fewer clicks overall, but the clicks and mentions you do earn are far more valuable. GEO is about winning **share of answer**, not share of SERP.
+
+## 2. How AI engines select and cite sources
+
+All major engines follow roughly the same four-stage pipeline (RAG — retrieval-augmented generation):
+
+1. **Query fan-out.** The engine decomposes the user's prompt (avg ~23 words, vs ~4 for classic Google) into multiple sub-queries and runs them against a search index (Google's index for AIO/Gemini; Bing for ChatGPT/Copilot; Perplexity's own crawl + partners).
+2. **Retrieval.** Top results are fetched and split into **chunks/passages**. The engine scores passages — not whole pages — for relevance to each sub-query.
+3. **Synthesis.** The LLM composes one answer from the selected passages, blending several sources.
+4. **Citation.** Sources whose passages materially contributed get linked/named.
+
+Key consequences you must design for:
+
+- **Passage-level competition.** A single self-contained, extractable paragraph can win a citation even from a low-authority site. Pages are chunked; each section competes independently.
+- **Non-determinism.** The same question asked five times yields five different answers. GEO success is a **frequency/mention rate** across many prompts, not a fixed position. Measure share of voice, not rank.
+- **Divergence from Google rankings.** Overlap between Google's top-10 and AI-cited sources has fallen from ~70% to under 20% for many query classes. Rank alone no longer predicts AI visibility.
+- **Two paths to visibility:** (a) your *pages* get cited; (b) your *brand* gets mentioned because third-party sources the AI trusts (review sites, Reddit, Wikipedia, industry listicles, news) mention you. Both must be worked.
+
+### Platform behavior differences (2026)
+
+| Engine | Index | Notable behavior |
+|---|---|---|
+| ChatGPT search | Bing + OpenAI crawl (GPTBot / OAI-SearchBot) | ~70% AI-chat market share; favors comprehensive, well-sourced content; largest referral source |
+| Google AI Overviews / AI Mode | Google index | Traditional ranking + snippet eligibility feed selection; Google's official position: "optimizing for AI search is still SEO" — indexed + snippet-eligible is the only requirement |
+| Perplexity | Own crawler (PerplexityBot) + partners | Most citation-forward UI; strong recency bias; high-intent B2B/SaaS traffic |
+| Gemini | Google index | Fastest-growing; inherits Google E-E-A-T signals |
+| Claude | Brave-backed search + ClaudeBot | Favors well-structured, logically organized content |
+
+## 3. GEO vs SEO — what changes, what doesn't
+
+| Factor | SEO | GEO |
+|---|---|---|
+| Output | Ranked links | One synthesized answer |
+| Unit of competition | Page | Passage/chunk + entity (brand) |
+| Query | ~4 words, keyword | ~23 words, conversational, multi-intent |
+| Success metric | Rank, CTR, clicks | Citation rate, share of voice, mention accuracy, AI referrals |
+| Levers | Backlinks, keywords, CWV | Factual density, extractable structure, entity clarity, off-site mentions, freshness |
+| Determinism | Stable rankings | Probabilistic; sample many prompts |
+
+**What carries over unchanged:** crawlability, indexation, E-E-A-T, quality content, internal linking, clean information architecture, backlinks (they still shape what retrieval surfaces). GEO is a superset of technical SEO, not a replacement. Google explicitly states no new files or markup are required for AI features — but the *competitive* levers above decide who actually gets cited.
+
+**The foundational research:** the Princeton/Georgia Tech/IIT "GEO" paper (Aggarwal et al., KDD 2024) that coined the term found that adding **citations, quotations from credible sources, and statistics** boosted content visibility in generative responses by **30–40%** — while classic keyword stuffing did nothing or hurt. Factual density is the single strongest content lever; every subsequent industry study has confirmed it.
+
+## 4. What AI engines reward (ranked by leverage)
+
+1. **Answer-first, self-contained passages.** A 2–4 sentence direct answer at the top of the page/section that includes a concrete fact, number, or named entity. This is the #1 highest-leverage fix.
+2. **Factual density.** Statistics with named sources, expert quotes with name/title/company, dates, original data. Pages with structured lists, quotes, and stats show 30–40% higher AI visibility.
+3. **Entity clarity.** The engine must unambiguously know *who you are*: consistent brand name, clear "what we do" phrasing, Organization schema, Wikipedia/Wikidata/Crunchbase presence, consistent NAP.
+4. **Off-site corroboration.** Mentions on Reddit, review platforms (G2, Trustpilot), industry listicles, news, and Wikipedia — the sources AI engines already trust and re-cite. The fastest GEO win is getting mentioned in a page that's *already* being cited for your target prompts.
+5. **Freshness.** ~65% of AI bot hits target content published/updated within the past year; citations to pages older than ~3 months drop off sharply on fast-moving topics. Visible dates + `dateModified` schema + real content updates.
+6. **Extractable structure.** Semantic HTML, strict H1→H2→H3 hierarchy, short paragraphs, lists, tables, Q&A blocks — see `geo-tactics-checklist.md` §Design/Architecture.
+7. **Machine accessibility.** Server-rendered HTML (most AI crawlers do NOT execute JavaScript), AI bots allowed in robots.txt, no paywalls/CDN bot-blocking on citable content, fast responses.
+
+## 5. How website design & architecture affect GEO
+
+This is where a design/dev assistant has direct influence:
+
+- **Rendering:** AI crawlers (GPTBot, ClaudeBot, PerplexityBot) generally don't run JS. Client-side-rendered content is invisible to them. Use SSR/SSG for all citable content; check `curl` output equals visible content.
+- **Chunk-friendly layout:** engines split pages into passages. Every H2/H3 section should stand alone: heading phrased as the question/claim, first sentence answers it, supporting detail follows. Avoid meaning that only emerges from surrounding context ("as mentioned above...").
+- **Semantic HTML:** `<main>`, `<article>`, `<section>`, `<table>`, `<ul>`, real heading tags — not styled `<div>`s. Heading hierarchy alone carries meaningful citation weight because it defines chunk boundaries.
+- **Content-to-chrome ratio:** heavy nav/footers/popups dilute extraction. Keep the answer content dominant in the DOM.
+- **Topic-cluster IA:** one topic per page, clear hub-and-spoke internal linking, logical URL taxonomy. This is how engines infer topical authority and entity relationships.
+- **Speed:** faster responses = deeper crawl per session by AI bots (they have small crawl budgets). Cloudflare reports GPTBot request volume up 300%+ YoY — make those fetches count.
+
+## 6. Measuring GEO
+
+Because answers are non-deterministic, measurement = **sampling prompts repeatedly** and tracking rates.
+
+**Core metrics:**
+- **AI share of voice** — % of sampled prompts where your brand appears vs competitors.
+- **Citation rate** — % of prompts where your *URL* is cited; which pages get cited.
+- **Mention accuracy/sentiment** — does the AI describe you correctly and favorably?
+- **AI referral traffic** — sessions from `chat.openai.com` / `chatgpt.com`, `perplexity.ai`, `gemini.google.com`, `copilot.microsoft.com` referrers (GA4 channel group or regex segment). Track conversion rate separately — expect it to beat organic ~4x.
+- **AI crawler activity** — server-log hits from GPTBot, OAI-SearchBot, ClaudeBot, Claude-User, PerplexityBot, Google-Extended, Bytespider. Crawling precedes citing.
+- **Google surface** — AI Overview traffic is inside Search Console's Performance report ("Web" type); no separate breakout exists, so watch impressions-vs-clicks divergence.
+
+**Tool landscape (2026):**
+- **Profound** — enterprise standard (Ramp, MongoDB, IBM); monitors 10+ engines via real consumer frontends; G2 Leader in AEO, Winter 2026.
+- **Peec AI** — agency favorite; Citation Gap Analysis (maps which sources AI trusts in your category).
+- **Otterly.ai** — most accessible entry point; 20k+ users; Gartner Cool Vendor 2025.
+- Others: Rankscale, Omnia, LLMrefs, Scrunch, plus AI-visibility modules inside Semrush (AI Toolkit) and Ahrefs (Brand Radar).
+- **Free baseline:** manually run a fixed panel of 20–50 buyer prompts monthly across ChatGPT/Perplexity/AIO and log brand mentions + citations in a sheet.
+
+## 7. Strategic rules of thumb
+
+1. Optimize for the **question**, not the keyword. Every important page should map to real conversational prompts.
+2. Win **passages**, then pages, then the entity. Fix your top-10 revenue pages first with answer-first blocks.
+3. Spend ~40% of GEO effort **off-site** (Reddit, reviews, listicles, PR, Wikipedia-tier references) — AI engines cite the web's consensus about you, not just your site.
+4. Treat freshness as a feature: quarterly refresh cadence on money pages, with real changes, updated stats, and honest `dateModified`.
+5. Never sacrifice human UX for bots — Google's guidance is explicit that AI features run on ordinary search signals; content made unreadable for humans loses both channels.

package/knowledge/geo/geo-tactics-checklist.md

@@ -0,0 +1,148 @@
+---
+id: geo-tactics-checklist
+title: "GEO Tactics Checklist — Get Cited by AI Engines"
+category: geo
+platform: web
+tags: [ai-search, llm, citations, llms-txt, schema, checklist]
+sources: ["https://llmrefs.com/generative-engine-optimization", "https://searchengineland.com/guide/optimize-for-ai-crawlers", "https://llmstxt.org/", "https://developers.google.com/search/docs/appearance/ai-features", "https://nextgrowth.ai/geo-best-practices-ai-citations/", "https://totheweb.com/blog/beyond-seo-your-geo-checklist-mastering-content-creation-for-ai-search-engines/", "https://www.lumar.io/blog/best-practice/4-pillar-geo-strategy-framework-for-ai-search-visibility/", "https://authoritytech.io/curated/answer-engine-optimization-checklist-chatgpt-perplexity-claude-2026", "https://www.averi.ai/learn/the-definitive-guide-to-geo-get-cited-by-ai-in-2026"]
+updated: 2026-07-08
+---
+
+# GEO Tactics Checklist — Get Cited by AI Engines (2026)
+
+Prescriptive, in priority order. Apply to money pages first, then roll out sitewide.
+
+## 1. Content structure — answer-first (highest leverage)
+
+- [ ] **Open every page with a self-contained answer block**: 2–4 sentences, directly under the H1, that fully answers the page's core question and includes at least one specific statistic, date, or named entity. AI engines extract these as canonical passages.
+- [ ] **One question per H2/H3 section.** Phrase headings as the actual questions users ask ("How much does a website redesign cost in 2026?"), answer in the section's first sentence, elaborate after.
+- [ ] **Make every section standalone.** No "as mentioned above" — chunks are retrieved out of context. Repeat the subject noun instead of pronouns at section starts.
+- [ ] Paragraphs ≤ 3 sentences. Use bullets, numbered steps, and comparison tables — pages with structured lists, quotes, and statistics show **30–40% higher AI visibility** (Princeton GEO study, confirmed by later industry studies).
+- [ ] **Add a Q&A/FAQ block** (3–6 real questions from sales calls, Reddit, "People Also Ask") near the end of key pages.
+- [ ] Include a **TL;DR or "Key takeaways"** bulleted summary near the top of long pages.
+
+**Answer-first example (put this pattern under the H1):**
+
+> **Bad:** "In today's fast-moving digital landscape, businesses of all sizes are asking how they can improve their online presence..."
+>
+> **Good:** "A small-business website redesign in 2026 typically costs £3,000–£12,000 and takes 4–8 weeks. The price is driven by three factors: page count, custom design vs. template, and CMS complexity. Below is a line-item breakdown based on 40 studio projects delivered in 2025."
+
+## 2. Factual density — citations, statistics, quotes
+
+- [ ] Every important claim carries a **number + named source + year**: "According to Semrush (2025), AI-referred visitors convert 4.4x higher than organic."
+- [ ] Add **expert quotes with full attribution** (name, title, company). Unattributed quotes carry near-zero weight.
+- [ ] Publish **original data** (surveys, benchmarks, case-study metrics). Original statistics are the most re-citable asset a brand can own — other sites cite you, and AI engines cite them citing you.
+- [ ] Link out to authoritative primary sources; engines treat well-sourced pages as trustworthy synthesis candidates.
+- [ ] Show **author bio with credentials** on every article (name, role, experience, LinkedIn). E-E-A-T still gates retrieval.
+
+## 3. Entity clarity — make the brand machine-legible
+
+- [ ] Use **one exact brand name spelling** everywhere (site, socials, directories, schema). Inconsistency splits the entity.
+- [ ] Write a canonical one-sentence definition and reuse it verbatim on the homepage, About page, and schema `description`: "Example Studio is a web design studio that builds conversion-focused websites for small businesses."
+- [ ] Create/claim entity homes: **Wikidata, Crunchbase, LinkedIn company page, Google Business Profile**, key industry directories — consistent name, description, URL, logo.
+- [ ] Add `Organization` schema sitewide with `sameAs` links to every profile (see §5 snippet).
+- [ ] Define niche jargon in plain words on first use; engines can't cite what they can't parse.
+
+## 4. Off-site brand mentions (≈40% of GEO effort)
+
+- [ ] **Find the pages AI already cites** for your target prompts (ask ChatGPT/Perplexity your 20 core buyer questions; log every cited URL). Get your brand into those exact pages: comment, contribute, request inclusion, or pitch listicle authors.
+- [ ] Maintain honest, active presence on **Reddit and niche forums** — heavily weighted in ChatGPT and Perplexity training/retrieval. Genuine answers only; spam gets pruned and nukes trust.
+- [ ] Collect reviews on **G2 / Trustpilot / Clutch / Google** — AI engines lean on review aggregators for "best X" prompts.
+- [ ] Pitch **digital PR and data stories** to industry publications; a mention in one trusted article propagates into many AI answers.
+- [ ] Target inclusion in "**best [category] 2026**" roundups — these dominate commercial-intent AI answers.
+
+## 5. Schema markup for LLMs
+
+Schema is the metadata layer engines use to verify who/what/when. Align it exactly with visible content (Google requirement). Priority types: `Organization`, `WebSite`, `Article`/`BlogPosting` (with dates + author), `FAQPage`, `HowTo`, `Product`/`Service` + `Review`, `BreadcrumbList`, `Person` for authors.
+
+```html
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": "Website Redesign Costs in 2026: Full Breakdown",
+  "description": "Line-item pricing for small-business website redesigns in 2026.",
+  "author": { "@type": "Person", "name": "Jane Doe",
+              "jobTitle": "Founder, Example Studio",
+              "url": "https://example.com/about" },
+  "publisher": { "@type": "Organization", "name": "Example Studio",
+                 "url": "https://example.com",
+                 "logo": { "@type": "ImageObject", "url": "https://example.com/logo.png" },
+                 "sameAs": ["https://www.linkedin.com/company/example",
+                            "https://www.crunchbase.com/organization/example"] },
+  "datePublished": "2026-01-14",
+  "dateModified": "2026-07-01"
+}
+</script>
+```
+
+- [ ] `datePublished` **and** `dateModified` on every article — ~65% of AI bot hits target content updated within the past year.
+- [ ] `FAQPage` schema on pages with Q&A blocks; questions must match visible text verbatim.
+- [ ] Validate with Google's Rich Results Test / schema.org validator after every template change.
+
+## 6. llms.txt and machine-readable content
+
+Status 2026: an emerging convention (llmstxt.org), adopted by many dev-tool and SaaS sites; large-scale tests show **no measurable citation lift yet** and Google says no AI text files are required — implement it as a cheap, low-risk hedge, never instead of items 1–5.
+
+- [ ] Serve `/llms.txt` at the site root: markdown, H1 title, blockquote summary, H2 link sections.
+- [ ] Optionally serve `/llms-full.txt` (full flattened content) and `.md` twins of key pages (`/pricing.md`).
+
+```markdown
+# Example Studio
+
+> UK web design studio building conversion-focused websites for small
+> businesses. Founded 2024. Services: web design, redesigns, GEO/SEO.
+
+## Services
+- [Web Design](https://example.com/services/web-design): Custom sites, 4–8 week delivery
+- [Website Redesign](https://example.com/services/redesign): Pricing and process
+- [GEO & SEO](https://example.com/services/geo): AI-search visibility services
+
+## Resources
+- [Pricing Guide 2026](https://example.com/pricing): Line-item costs
+- [Case Studies](https://example.com/work): Results with metrics
+
+## Optional
+- [About](https://example.com/about)
+```
+
+## 7. Technical access — let AI bots in and feed them HTML
+
+- [ ] **robots.txt allows**: `GPTBot`, `OAI-SearchBot`, `ChatGPT-User`, `ClaudeBot`, `Claude-User`, `PerplexityBot`, `Perplexity-User`, `Google-Extended`, `Bingbot`. Blocking OAI-SearchBot/PerplexityBot removes you from those engines' citations entirely.
+- [ ] **Check CDN/WAF settings** — Cloudflare blocks AI crawlers by default on new zones; explicitly allow the bots you want.
+- [ ] **Server-render all citable content.** Most AI crawlers do not execute JavaScript; JS-injected content is invisible. Verify: `curl -A "GPTBot" https://yoursite.com/page` must contain the answer text.
+- [ ] No paywalls/login walls/interstitials in front of content you want cited.
+- [ ] XML sitemap with accurate `<lastmod>`, referenced from robots.txt.
+- [ ] Fast TTFB and clean canonical URLs — AI crawlers have shallow budgets; speed = more pages fetched per session.
+- [ ] Do NOT use `nosnippet` / restrictive `max-snippet` on pages you want in Google AI Overviews — snippet controls are Google's official opt-out mechanism for AI features.
+
+## 8. Design & architecture rules (for the build itself)
+
+- [ ] Semantic HTML5: `<main>`, `<article>`, `<section>`, `<nav>`, real `<h1>`–`<h3>` (single H1), `<table>` for tabular data, `<ul>/<ol>` for lists — never styled `<div>` soup. Heading hierarchy defines the chunk boundaries retrieval uses.
+- [ ] High content-to-chrome ratio: answer content dominant in the DOM; minimal boilerplate above the first H1; no content trapped in carousels, tabs, or accordions that require JS to render into the DOM (accordions are fine if content is in the initial HTML).
+- [ ] Text over images for facts: never put statistics, pricing, or key claims only inside images/infographics — provide the same data as HTML text or tables, with descriptive `alt`.
+- [ ] Topic-cluster IA: one intent per URL, hub pages linking to spoke pages with descriptive anchor text, breadcrumbs + `BreadcrumbList` schema.
+- [ ] Visible "Last updated: {date}" near the top of articles, backed by matching `dateModified` schema.
+
+## 9. Freshness cadence
+
+- [ ] Refresh top money pages **quarterly**: update stats to current-year sources, add a new section, revise the answer block. Citations to stale pages (>3 months on fast topics) drop sharply.
+- [ ] Update the year in titles/H1s only when content genuinely reflects it — fake freshness is detectable and hurts trust.
+- [ ] Keep publishing new pages targeting emerging conversational queries; Perplexity especially rewards recency.
+
+## 10. Measurement loop (monthly)
+
+- [ ] Maintain a fixed panel of 20–50 real buyer prompts; run across ChatGPT, Perplexity, Google AI Mode/AIO, Gemini. Log: brand mentioned? URL cited? which competitor won? description accurate?
+- [ ] Track AI referrals in GA4: regex channel for `chatgpt.com|chat.openai.com|perplexity.ai|gemini.google.com|copilot.microsoft.com`; report sessions **and** conversion rate.
+- [ ] Grep server logs for AI crawler hits (GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot) — rising crawl of a page usually precedes citations.
+- [ ] Consider a tracking tool once manual sampling proves value: Otterly (entry-level), Peec AI (agencies, citation-gap analysis), Profound (enterprise), or Semrush AI Toolkit / Ahrefs Brand Radar add-ons.
+- [ ] KPI set: AI share of voice, citation rate per page, mention accuracy, AI referral sessions + CVR, AIO impression/click divergence in Search Console.
+
+## Anti-patterns — never do
+
+- Keyword stuffing or "AI-optimized" gibberish appended for bots (the original GEO study found it does nothing or backfires).
+- Blocking AI crawlers on marketing content "to protect IP" while expecting AI visibility.
+- Schema that contradicts visible content (Google penalizes; engines distrust).
+- Astroturfing Reddit/reviews — moderation removal plus brand-sentiment damage inside AI answers.
+- Shipping citable content behind client-side rendering, infinite scroll, or JS-gated tabs.
+- Chasing llms.txt or exotic markup before the answer-first content and entity basics are done.