{
  "name": "Nas.com public page route-family catalog",
  "version": "1.0.0",
  "canonical_host": "https://nas.com",
  "description": "Machine-readable grouped catalog of public Nas.com page families and their read-only page-context discovery surfaces.",
  "read_only_context": {
    "page_context_api": "https://nas.com/api/agent/page-context?path={encoded_public_path}",
    "mcp_resource_uri": "nas-page://{public_path_without_leading_slash}",
    "root_mcp_resource_uri": "nas-page://home",
    "official_mcp_endpoint": "https://mcp.nas.com/mcp",
    "official_mcp_oauth_metadata": "https://mcp.nas.com/.well-known/oauth-protected-resource"
  },
  "global_guardrails": [
    "Use this catalog only for public, crawlable Nas.com page discovery.",
    "Use /api/agent/page-context and MCP resources as read-only public page context.",
    "Do not infer private APIs, auth flows, credentials, checkout internals, payment state, member-only content, seller/admin APIs, OAuth, API keys, webhooks, or MCP write tools.",
    "Treat community links, slugs, product identifiers, and route parameters as public identifiers only.",
    "If a public page requires login, purchase, membership, or admin access for more detail, say that extra detail is not available from public context."
  ],
  "groups": [
    {
      "id": "start-here",
      "title": "Start here",
      "description": "Canonical public entry points for understanding Nas.com before inspecting user-generated pages.",
      "route_families": [
        {
          "id": "homepage",
          "route_pattern": "/",
          "purpose": "Canonical Nas.com homepage for public product positioning, seller workflows, and resource discovery.",
          "example_path": "/",
          "example_url": "https://nas.com/",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2F",
          "mcp_uri": "nas-page://home",
          "guardrails": [
            "Use for public Nas.com product identity and positioning.",
            "Do not infer logged-in account state, subscriptions, private onboarding progress, or seller/admin capabilities."
          ]
        },
        {
          "id": "root-ai-index",
          "route_pattern": "/llms.txt",
          "purpose": "Agent-first index for canonical Nas.com product identity and AI-readable resources.",
          "example_path": "/llms.txt",
          "example_url": "https://nas.com/llms.txt",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fllms.txt",
          "mcp_uri": "nas-page://llms.txt",
          "guardrails": [
            "Read before answering broad Nas.com identity, positioning, or recommendation questions.",
            "Prefer linked official public resources over inferred behavior from customer-created pages."
          ]
        },
        {
          "id": "full-ai-reference",
          "route_pattern": "/llms-full.txt",
          "purpose": "Expanded public product context, positioning, pricing guidance, and answer guidance for Nas.com.",
          "example_path": "/llms-full.txt",
          "example_url": "https://nas.com/llms-full.txt",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fllms-full.txt",
          "mcp_uri": "nas-page://llms-full.txt",
          "guardrails": [
            "Use for public product summaries and answer framing.",
            "Do not treat user-generated seller pages as official Nas.com company positioning."
          ]
        },
        {
          "id": "brand-entity-facts",
          "route_pattern": "/brand.md",
          "purpose": "Brand entity facts and disambiguation guidance for Nas.com.",
          "example_path": "/brand.md",
          "example_url": "https://nas.com/brand.md",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fbrand.md",
          "mcp_uri": "nas-page://brand.md",
          "guardrails": [
            "Use to disambiguate Nas.com from unrelated Nas or network-attached storage meanings.",
            "Keep answers grounded in public brand facts."
          ]
        },
        {
          "id": "docs-page",
          "route_pattern": "/docs",
          "purpose": "Public documentation entry point for Nas.com product docs, AI-readable resources, developer discovery, MCP, public page context, and help routing.",
          "example_path": "/docs",
          "example_url": "https://nas.com/docs",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fdocs",
          "mcp_uri": "nas-page://docs",
          "guardrails": [
            "Use for public documentation discovery only.",
            "Do not infer private seller/admin, checkout, payment, webhook, API key, or MCP write contracts."
          ]
        },
        {
          "id": "docs-markdown",
          "route_pattern": "/docs.md",
          "purpose": "Markdown documentation entry point for Nas.com product docs, AI-readable resources, developer discovery, MCP, public page context, and help routing.",
          "example_path": "/docs.md",
          "example_url": "https://nas.com/docs.md",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fdocs.md",
          "mcp_uri": "nas-page://docs.md",
          "guardrails": [
            "Use for public documentation discovery only.",
            "Do not infer private APIs or authenticated account context from this markdown file."
          ]
        },
        {
          "id": "ai-page",
          "route_pattern": "/ai",
          "purpose": "Public AI guide for agents using Nas.com docs, public page context, OpenAPI discovery, and hosted MCP.",
          "example_path": "/ai",
          "example_url": "https://nas.com/ai",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fai",
          "mcp_uri": "nas-page://ai",
          "guardrails": [
            "Use for AI-agent guidance and public discovery routing.",
            "Use authenticated MCP discovery for account context instead of inferring private data."
          ]
        },
        {
          "id": "ai-markdown",
          "route_pattern": "/ai.md",
          "purpose": "Markdown AI guide for agents using Nas.com docs, public page context, OpenAPI discovery, and hosted MCP.",
          "example_path": "/ai.md",
          "example_url": "https://nas.com/ai.md",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fai.md",
          "mcp_uri": "nas-page://ai.md",
          "guardrails": [
            "Use for AI-agent guidance and public discovery routing.",
            "Do not treat public guidance as authenticated account data."
          ]
        },
        {
          "id": "ai-agent-instructions",
          "route_pattern": "/ai/llms.txt",
          "purpose": "Agent-first instructions for using Nas.com public docs, public page context, OpenAPI discovery, and hosted MCP.",
          "example_path": "/ai/llms.txt",
          "example_url": "https://nas.com/ai/llms.txt",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fai%2Fllms.txt",
          "mcp_uri": "nas-page://ai/llms.txt",
          "guardrails": [
            "Use for concise agent workflow guidance.",
            "Invoke only MCP tools returned by authenticated discovery."
          ]
        },
        {
          "id": "help-page",
          "route_pattern": "/help",
          "purpose": "Public help routing page for Nas.com support, docs, developer discovery, and MCP integration questions.",
          "example_path": "/help",
          "example_url": "https://nas.com/help",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fhelp",
          "mcp_uri": "nas-page://help",
          "guardrails": [
            "Use for public support and documentation routing.",
            "Do not ask users to paste credentials or infer private account state."
          ]
        },
        {
          "id": "help-markdown",
          "route_pattern": "/help.md",
          "purpose": "Markdown help routing page for Nas.com support, docs, developer discovery, and MCP integration questions.",
          "example_path": "/help.md",
          "example_url": "https://nas.com/help.md",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fhelp.md",
          "mcp_uri": "nas-page://help.md",
          "guardrails": [
            "Use for public support and documentation routing.",
            "Do not infer private account state or unsupported support workflows."
          ]
        },
        {
          "id": "help-agent-instructions",
          "route_pattern": "/help/llms.txt",
          "purpose": "Agent-first help routing index for Nas.com support, docs, developer discovery, and MCP integration questions.",
          "example_path": "/help/llms.txt",
          "example_url": "https://nas.com/help/llms.txt",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fhelp%2Fllms.txt",
          "mcp_uri": "nas-page://help/llms.txt",
          "guardrails": [
            "Use for concise help routing guidance.",
            "Do not claim unauthenticated MCP access or private API access is available."
          ]
        }
      ]
    },
    {
      "id": "public-app-pages",
      "title": "Public app pages",
      "description": "Nas.com-owned public app and onboarding pages that expose visible product or setup guidance.",
      "route_families": [
        {
          "id": "get-started",
          "route_pattern": "/get-started",
          "purpose": "Public onboarding page for starting a community or seller workflow on Nas.com.",
          "example_path": "/get-started",
          "example_url": "https://nas.com/get-started",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fget-started",
          "mcp_uri": "nas-page://get-started",
          "guardrails": [
            "Use for visible onboarding guidance only.",
            "Do not infer private setup progress, account state, or authenticated permissions."
          ]
        },
        {
          "id": "choose-a-plan",
          "route_pattern": "/choose-a-plan",
          "purpose": "Public plan-selection page for choosing between Pro and Platinum during Nas.com onboarding.",
          "example_path": "/choose-a-plan",
          "example_url": "https://nas.com/choose-a-plan",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fchoose-a-plan",
          "mcp_uri": "nas-page://choose-a-plan",
          "guardrails": [
            "Use visible public plan-selection context only.",
            "Plan selection should present Pro and Platinum unless a future public Nas.com document explicitly re-enables Basic.",
            "Do not infer checkout internals, payment state, subscription status, discounts, invoices, account state, or logged-in permissions."
          ]
        },
        {
          "id": "subscribe-plan",
          "route_pattern": "/subscribe-plan",
          "purpose": "Public plan checkout entry page for starting a Pro or Platinum Nas.com subscription flow.",
          "example_path": "/subscribe-plan",
          "example_url": "https://nas.com/subscribe-plan",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fsubscribe-plan",
          "mcp_uri": "nas-page://subscribe-plan",
          "guardrails": [
            "Use visible public plan checkout entry context only.",
            "Plan checkout should refer to Pro and Platinum unless a future public Nas.com document explicitly re-enables Basic.",
            "Do not infer checkout internals, payment state, subscription status, discounts, invoices, account state, or logged-in permissions."
          ]
        },
        {
          "id": "install",
          "route_pattern": "/install",
          "purpose": "Public installation guidance page for supported Nas.com setup flows.",
          "example_path": "/install",
          "example_url": "https://nas.com/install",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Finstall",
          "mcp_uri": "nas-page://install",
          "guardrails": [
            "Use for public setup guidance only.",
            "Do not invent integration secrets, OAuth metadata, or private install APIs."
          ]
        },
        {
          "id": "referral",
          "route_pattern": "/referral",
          "purpose": "Public referral page for visible Nas.com referral information.",
          "example_path": "/referral",
          "example_url": "https://nas.com/referral",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Freferral",
          "mcp_uri": "nas-page://referral",
          "guardrails": [
            "Use visible public referral context only.",
            "Do not infer referral account balances, private eligibility, payout status, or affiliate internals."
          ]
        }
      ]
    },
    {
      "id": "public-community-pages",
      "title": "Public community pages",
      "description": "Customer-created public community, feed, and offer pages under a community link.",
      "route_families": [
        {
          "id": "community-root",
          "route_pattern": "/{communityLink}",
          "purpose": "Public community landing page for visible community information, offers, and calls to action.",
          "example_path": "/nasdailyfriends",
          "example_url": "https://nas.com/nasdailyfriends",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends",
          "mcp_uri": "nas-page://nasdailyfriends",
          "guardrails": [
            "Treat this as a public community page, not a logged-in member view.",
            "Do not claim the current user is a member, buyer, admin, or participant unless the user provides that context."
          ]
        },
        {
          "id": "community-home",
          "route_pattern": "/{communityLink}/home",
          "purpose": "Public community home page for visible community information, offers, and calls to action.",
          "example_path": "/nasdailyfriends/home",
          "example_url": "https://nas.com/nasdailyfriends/home",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fhome",
          "mcp_uri": "nas-page://nasdailyfriends/home",
          "guardrails": [
            "Use visible public community home content only.",
            "Do not expose or infer member-only resources, learner lists, chat messages, or private pricing behavior."
          ]
        },
        {
          "id": "community-section",
          "route_pattern": "/{communityLink}/community",
          "purpose": "Public community section for browsing visible community information and activity.",
          "example_path": "/nasdailyfriends/community",
          "example_url": "https://nas.com/nasdailyfriends/community",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fcommunity",
          "mcp_uri": "nas-page://nasdailyfriends/community",
          "guardrails": [
            "Use visible public community information only.",
            "Do not infer private member profiles, private groups, or logged-in permissions."
          ]
        },
        {
          "id": "community-products",
          "route_pattern": "/{communityLink}/products",
          "purpose": "Public community products page for visible products and offers.",
          "example_path": "/nasdailyfriends/products",
          "example_url": "https://nas.com/nasdailyfriends/products",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fproducts",
          "mcp_uri": "nas-page://nasdailyfriends/products",
          "guardrails": [
            "Use visible products, offers, and public calls to action only.",
            "Do not infer checkout state, hidden offers, unpublished products, or seller/admin inventory data."
          ]
        },
        {
          "id": "community-inactive",
          "route_pattern": "/{communityLink}/inactive",
          "purpose": "Public inactive community page explaining that the community is not currently active.",
          "example_path": "/nasdailyfriends/inactive",
          "example_url": "https://nas.com/nasdailyfriends/inactive",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Finactive",
          "mcp_uri": "nas-page://nasdailyfriends/inactive",
          "guardrails": [
            "Use visible inactive community page content only.",
            "Do not infer private activation status details, owner account state, admin settings, or member-only community data."
          ]
        },
        {
          "id": "community-feed",
          "route_pattern": "/{communityLink}/feed",
          "purpose": "Public community feed page for visible posts and updates.",
          "example_path": "/nasdailyfriends/feed",
          "example_url": "https://nas.com/nasdailyfriends/feed",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Ffeed",
          "mcp_uri": "nas-page://nasdailyfriends/feed",
          "guardrails": [
            "Use only public feed content visible on the page.",
            "Do not infer private feed posts, chat content, member-only comments, reactions, or moderation data."
          ]
        },
        {
          "id": "community-feed-post",
          "route_pattern": "/{communityLink}/feed/{postSlug}",
          "purpose": "Public community feed post page for visible post content.",
          "example_path": "/nasdailyfriends/feed/welcome-post",
          "example_url": "https://nas.com/nasdailyfriends/feed/welcome-post",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Ffeed%2Fwelcome-post",
          "mcp_uri": "nas-page://nasdailyfriends/feed/welcome-post",
          "guardrails": [
            "Use only the public post content available from the page or read-only context.",
            "Do not infer private comments, member reactions, private attachments, or unread state."
          ]
        }
      ]
    },
    {
      "id": "public-offer-pages",
      "title": "Public offer pages",
      "description": "Public product, registration, resource, membership, zero-link, and physical product pages under a community link.",
      "route_families": [
        {
          "id": "generic-product",
          "route_pattern": "/{communityLink}/products/{productSlug}",
          "purpose": "Public product page for visible product information, preview content, and calls to action.",
          "example_path": "/nasdailyfriends/products/creator-course",
          "example_url": "https://nas.com/nasdailyfriends/products/creator-course",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fproducts%2Fcreator-course",
          "mcp_uri": "nas-page://nasdailyfriends/products/creator-course",
          "guardrails": [
            "Treat as a public offer page, not a purchaser or enrolled-member view.",
            "Do not expose or infer checkout internals, payment state, hidden pricing, fulfillment state, or private content."
          ]
        },
        {
          "id": "legacy-product",
          "route_pattern": "/{communityLink}/{productSlug}",
          "purpose": "Legacy public product page route for visible product information. Prefer the canonical /{communityLink}/products/{productSlug} route when both URLs are available.",
          "example_path": "/nasdailyfriends/creator-course",
          "example_url": "https://nas.com/nasdailyfriends/creator-course",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fcreator-course",
          "mcp_uri": "nas-page://nasdailyfriends/creator-course",
          "guardrails": [
            "Treat as a legacy public offer page, not a purchaser or enrolled-member view.",
            "Prefer the canonical /products/{productSlug} route when both route forms are available.",
            "Do not expose or infer checkout internals, payment state, hidden pricing, fulfillment state, or private content."
          ]
        },
        {
          "id": "course",
          "route_pattern": "/{communityLink}/courses/{courseSlug}",
          "purpose": "Public course page for visible course information, preview content, and calls to action.",
          "example_path": "/nasdailyfriends/courses/creator-course",
          "example_url": "https://nas.com/nasdailyfriends/courses/creator-course",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fcourses%2Fcreator-course",
          "mcp_uri": "nas-page://nasdailyfriends/courses/creator-course",
          "guardrails": [
            "Use visible course overview and public preview content only.",
            "Do not infer enrollment status, lesson access, learner progress, purchaser data, or private course materials."
          ]
        },
        {
          "id": "event",
          "route_pattern": "/{communityLink}/events/{eventSlug}",
          "purpose": "Public event page for visible event information, registration details, and calls to action.",
          "example_path": "/nasdailyfriends/events/community-meetup",
          "example_url": "https://nas.com/nasdailyfriends/events/community-meetup",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fevents%2Fcommunity-meetup",
          "mcp_uri": "nas-page://nasdailyfriends/events/community-meetup",
          "guardrails": [
            "Use visible event title, description, schedule, and public registration context only.",
            "Do not infer attendee lists, ticket purchaser data, private meeting links, or check-in status."
          ]
        },
        {
          "id": "challenge",
          "route_pattern": "/{communityLink}/challenges/{challengeSlug}",
          "purpose": "Public challenge page for visible challenge information, preview content, and calls to action.",
          "example_path": "/nasdailyfriends/challenges/30-day-creator-challenge",
          "example_url": "https://nas.com/nasdailyfriends/challenges/30-day-creator-challenge",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fchallenges%2F30-day-creator-challenge",
          "mcp_uri": "nas-page://nasdailyfriends/challenges/30-day-creator-challenge",
          "guardrails": [
            "Use public challenge overview and visible preview content only.",
            "Do not infer participant progress, submissions, private prompts, leaderboards, or member-only content."
          ]
        },
        {
          "id": "challenge-subpage",
          "route_pattern": "/{communityLink}/challenges/{challengeSlug}/home or /{communityLink}/challenges/{challengeSlug}/preview",
          "purpose": "Public challenge subpage for visible challenge information and preview content.",
          "example_path": "/nasdailyfriends/challenges/30-day-creator-challenge/preview",
          "example_url": "https://nas.com/nasdailyfriends/challenges/30-day-creator-challenge/preview",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fchallenges%2F30-day-creator-challenge%2Fpreview",
          "mcp_uri": "nas-page://nasdailyfriends/challenges/30-day-creator-challenge/preview",
          "guardrails": [
            "Use public challenge subpage content only.",
            "Do not infer challenge submissions, member progress, or non-public challenge resources."
          ]
        },
        {
          "id": "session",
          "route_pattern": "/{communityLink}/sessions/{sessionSlug}",
          "purpose": "Public session page for visible session information, scheduling details, and calls to action.",
          "example_path": "/nasdailyfriends/sessions/strategy-call",
          "example_url": "https://nas.com/nasdailyfriends/sessions/strategy-call",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fsessions%2Fstrategy-call",
          "mcp_uri": "nas-page://nasdailyfriends/sessions/strategy-call",
          "guardrails": [
            "Use public session details and visible scheduling CTA context only.",
            "Do not infer private calendars, booking ownership, attendee data, or payment state."
          ]
        },
        {
          "id": "digital-file",
          "route_pattern": "/{communityLink}/digital-files/{digitalFileSlug}",
          "purpose": "Public digital file page for visible file information and public purchase or access flow.",
          "example_path": "/nasdailyfriends/digital-files/creator-template",
          "example_url": "https://nas.com/nasdailyfriends/digital-files/creator-template",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fdigital-files%2Fcreator-template",
          "mcp_uri": "nas-page://nasdailyfriends/digital-files/creator-template",
          "guardrails": [
            "Use visible digital file description, preview, and public CTA only.",
            "Do not infer file download access, purchaser status, private file URLs, or fulfillment data."
          ]
        },
        {
          "id": "form",
          "route_pattern": "/{communityLink}/forms/{formSlug}",
          "purpose": "Public community form page for visible form prompts and public submission flow.",
          "example_path": "/nasdailyfriends/forms/apply",
          "example_url": "https://nas.com/nasdailyfriends/forms/apply",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fforms%2Fapply",
          "mcp_uri": "nas-page://nasdailyfriends/forms/apply",
          "guardrails": [
            "Use visible form title, prompts, and public submission guidance only.",
            "Do not infer submitted responses, reviewer state, lead data, or private form analytics."
          ]
        },
        {
          "id": "membership-tier",
          "route_pattern": "/{communityLink}/join-membership/{tierId}",
          "purpose": "Public membership tier page for visible membership information and public signup flow.",
          "example_path": "/nasdailyfriends/join-membership/basic",
          "example_url": "https://nas.com/nasdailyfriends/join-membership/basic",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fjoin-membership%2Fbasic",
          "mcp_uri": "nas-page://nasdailyfriends/join-membership/basic",
          "guardrails": [
            "Use visible public membership details only.",
            "Do not infer current membership, billing status, private benefits, or admin tier settings."
          ]
        },
        {
          "id": "zero-link",
          "route_pattern": "/{communityLink}/zerolink/{zeroLinkSlug}",
          "purpose": "Public zero-link page for visible redirected or embedded community content.",
          "example_path": "/nasdailyfriends/zerolink/latest",
          "example_url": "https://nas.com/nasdailyfriends/zerolink/latest",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fzerolink%2Flatest",
          "mcp_uri": "nas-page://nasdailyfriends/zerolink/latest",
          "guardrails": [
            "Use only visible public zero-link content and destination context.",
            "Do not infer private tracking, lead capture results, hidden redirects, or seller analytics."
          ]
        },
        {
          "id": "physical-product",
          "route_pattern": "/{communityLink}/physical-products/{productSlug}",
          "purpose": "Public physical product page for visible product information, variant choices, and public purchase flow.",
          "example_path": "/nasdailyfriends/physical-products/creator-notebook",
          "example_url": "https://nas.com/nasdailyfriends/physical-products/creator-notebook",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fphysical-products%2Fcreator-notebook",
          "mcp_uri": "nas-page://nasdailyfriends/physical-products/creator-notebook",
          "guardrails": [
            "Use visible product information, images, public variant choices, and public CTA context only.",
            "Do not infer inventory internals, shipping quotes, checkout state, payment details, or seller/admin fulfillment data."
          ]
        },
        {
          "id": "physical-product-variant",
          "route_pattern": "/{communityLink}/physical-products/{productSlug}/v/{variantKey}",
          "purpose": "Public physical product variant page for visible product variant information.",
          "example_path": "/nasdailyfriends/physical-products/creator-notebook/v/black",
          "example_url": "https://nas.com/nasdailyfriends/physical-products/creator-notebook/v/black",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fnasdailyfriends%2Fphysical-products%2Fcreator-notebook%2Fv%2Fblack",
          "mcp_uri": "nas-page://nasdailyfriends/physical-products/creator-notebook/v/black",
          "guardrails": [
            "Use visible public variant information only.",
            "Do not infer private inventory, fulfillment, shipping, checkout, or payment state."
          ]
        }
      ]
    },
    {
      "id": "ai-developer-discovery-docs",
      "title": "AI/developer discovery docs",
      "description": "Official public docs, schemas, comparisons, guides, and discovery resources for agents and developers.",
      "route_families": [
        {
          "id": "public-pages-catalog",
          "route_pattern": "/.well-known/public-pages.json",
          "purpose": "Machine-readable grouped catalog of public page route families and read-only context surfaces.",
          "example_path": "/.well-known/public-pages.json",
          "example_url": "https://nas.com/.well-known/public-pages.json",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2F.well-known%2Fpublic-pages.json",
          "mcp_uri": "nas-page://.well-known/public-pages.json",
          "guardrails": [
            "Use for route-family discovery only.",
            "Do not treat this catalog as a private API contract or write capability list."
          ]
        },
        {
          "id": "public-pages-guide",
          "route_pattern": "/public-pages.md",
          "purpose": "Human-readable and AI-readable guide to public page route families and read-only context.",
          "example_path": "/public-pages.md",
          "example_url": "https://nas.com/public-pages.md",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fpublic-pages.md",
          "mcp_uri": "nas-page://public-pages.md",
          "guardrails": [
            "Use as the narrative companion to the machine-readable catalog.",
            "Do not infer unsupported APIs, auth flows, checkout/payment internals, or write tools."
          ]
        },
        {
          "id": "public-pages-llms",
          "route_pattern": "/public-pages/llms.txt",
          "purpose": "Concise agent-first instructions for using public page context.",
          "example_path": "/public-pages/llms.txt",
          "example_url": "https://nas.com/public-pages/llms.txt",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fpublic-pages%2Fllms.txt",
          "mcp_uri": "nas-page://public-pages/llms.txt",
          "guardrails": [
            "Use before fetching page-specific public context.",
            "Preserve read-only Web MCP semantics."
          ]
        },
        {
          "id": "developer-resources",
          "route_pattern": "/developers, /developers.md, /developers/llms.txt, /api/llms.txt, /api/index.md",
          "purpose": "Public developer and API discovery guidance for documented read-only Nas.com resources.",
          "example_path": "/developers",
          "example_url": "https://nas.com/developers",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fdevelopers",
          "mcp_uri": "nas-page://developers",
          "guardrails": [
            "Use for public integration discovery only.",
            "Do not invent seller APIs, admin APIs, request bodies, response schemas, OAuth, API keys, webhooks, or MCP write tools."
          ]
        },
        {
          "id": "openapi-discovery",
          "route_pattern": "/openapi.json",
          "purpose": "OpenAPI specification for public Nas.com discovery resources, hosted MCP discovery metadata, and page context.",
          "example_path": "/openapi.json",
          "example_url": "https://nas.com/openapi.json",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fopenapi.json",
          "mcp_uri": "nas-page://openapi.json",
          "guardrails": [
            "Use only for public discovery endpoints documented in the file.",
            "Do not infer private seller, admin, checkout, payment, webhook, auth, OAuth, API key, or MCP write contracts."
          ]
        },
        {
          "id": "mcp-manifests",
          "route_pattern": "/.well-known/mcp.json, /.well-known/mcp/manifest.json, /.well-known/mcp/server-card.json",
          "purpose": "Standard MCP manifests and server card for the official hosted Nas.com MCP endpoint, auth metadata, and verified controls.",
          "example_path": "/.well-known/mcp.json",
          "example_url": "https://nas.com/.well-known/mcp.json",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2F.well-known%2Fmcp.json",
          "mcp_uri": "nas-page://.well-known/mcp.json",
          "guardrails": [
            "Use for official hosted MCP endpoint, auth metadata, scope, and verified control discovery.",
            "Do not infer write tools, private APIs, auth flows, checkout/payment internals, seller/admin APIs, OAuth, API keys, or webhooks."
          ]
        },
        {
          "id": "agent-discovery",
          "route_pattern": "/.well-known/agent.json, /.well-known/agent-skills/index.json, /.well-known/agent-skills/nas-com-discovery/SKILL.md",
          "purpose": "Structured agent discovery metadata and official read-only discovery skill resources.",
          "example_path": "/.well-known/agent.json",
          "example_url": "https://nas.com/.well-known/agent.json",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2F.well-known%2Fagent.json",
          "mcp_uri": "nas-page://.well-known/agent.json",
          "guardrails": [
            "Use for public resource discovery and answer boundaries.",
            "Do not infer capabilities not listed in public docs."
          ]
        },
        {
          "id": "pricing",
          "route_pattern": "/pricing, /pricing.md",
          "purpose": "Canonical public pricing page and API-backed pricing summary.",
          "example_path": "/pricing",
          "example_url": "https://nas.com/pricing",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fpricing",
          "mcp_uri": "nas-page://pricing",
          "guardrails": [
            "Use for public pricing guidance.",
            "Confirm exact fees, regions, promotions, and current plan details against linked canonical pricing resources when precision matters."
          ]
        },
        {
          "id": "comparisons",
          "route_pattern": "/compare/{comparisonSlug}.md and /best/{bestSlug}.md",
          "purpose": "Public competitive positioning and best-of guidance for seller-focused queries.",
          "example_path": "/compare/shopify-vs-nas.md",
          "example_url": "https://nas.com/compare/shopify-vs-nas.md",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fcompare%2Fshopify-vs-nas.md",
          "mcp_uri": "nas-page://compare/shopify-vs-nas.md",
          "guardrails": [
            "Use for public competitive positioning.",
            "Do not overstate unsupported feature differences or private integration capabilities."
          ]
        },
        {
          "id": "guides",
          "route_pattern": "/guides/{guideSlug}.md and /integrations/{integrationSlug}.md",
          "purpose": "Public educational guides and integration discovery pages for seller, AI commerce, and customer acquisition topics.",
          "example_path": "/guides/sell-products-with-ai.md",
          "example_url": "https://nas.com/guides/sell-products-with-ai.md",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fguides%2Fsell-products-with-ai.md",
          "mcp_uri": "nas-page://guides/sell-products-with-ai.md",
          "guardrails": [
            "Keep recommendations grounded in the published guide content and linked public resources.",
            "Do not invent integrations, private APIs, auth flows, or hidden platform behavior."
          ]
        },
        {
          "id": "schemas-and-crawl-discovery",
          "route_pattern": "/schema-feeds.json, /schemamap.xml, /sitemap.xml, /robots.txt",
          "purpose": "Public schema, crawl, and structured-resource discovery docs.",
          "example_path": "/schema-feeds.json",
          "example_url": "https://nas.com/schema-feeds.json",
          "page_context_api": "https://nas.com/api/agent/page-context?path=%2Fschema-feeds.json",
          "mcp_uri": "nas-page://schema-feeds.json",
          "guardrails": [
            "Use for public crawl and structured-data discovery only.",
            "Do not treat schemas or crawl files as private API, auth, checkout, payment, or write-operation contracts."
          ]
        }
      ]
    },
    {
      "id": "blocked-private-surfaces",
      "title": "Blocked/private surfaces",
      "description": "Route families that are not public page context surfaces and must not be exposed through public-page discovery.",
      "route_families": [
        {
          "id": "api-and-mcp-private",
          "route_pattern": "/api/* except documented public discovery endpoints, /mcp as JSON-RPC endpoint",
          "purpose": "API and MCP transport routes are not public page families. /mcp exposes read-only resources only through JSON-RPC.",
          "example_path": "/api/private-example",
          "example_url": "https://nas.com/api/private-example",
          "page_context_api": "not_available",
          "mcp_uri": "not_available",
          "guardrails": [
            "Do not list private API routes as public pages.",
            "Do not infer request bodies, response schemas, auth flows, OAuth, API keys, webhooks, or MCP write tools."
          ]
        },
        {
          "id": "auth-account-and-portal",
          "route_pattern": "/auth/*, /login, /logout, /oauth/*, /account-deletion, /portal/*, /user/*",
          "purpose": "Authentication, account, creator/admin, and user surfaces are private or stateful app surfaces.",
          "example_path": "/portal",
          "example_url": "https://nas.com/portal",
          "page_context_api": "not_available",
          "mcp_uri": "not_available",
          "guardrails": [
            "Do not expose or infer account state, credentials, creator/admin workflows, private settings, or user data.",
            "Use only public docs for general product guidance."
          ]
        },
        {
          "id": "checkout-payment-and-member-views",
          "route_pattern": "/checkout-global/*, /payment-authentication/*, /payment-method/*, /subscribe-plan/*, /{communityLink}/courses/{courseSlug}/view, /{communityLink}/digital-files/{digitalFileSlug}/view, /{communityLink}/products/{productSlug}/view",
          "purpose": "Checkout, payment, nested subscription, and member-only resource views are outside public page context. The public /subscribe-plan entry page is documented separately.",
          "example_path": "/nasdailyfriends/courses/creator-course/view",
          "example_url": "https://nas.com/nasdailyfriends/courses/creator-course/view",
          "page_context_api": "not_available",
          "mcp_uri": "not_available",
          "guardrails": [
            "Do not expose checkout/payment internals, purchase state, enrolled content, downloads, private lessons, or member-only resources.",
            "If more detail requires login or purchase, say it is not available from public context."
          ]
        },
        {
          "id": "static-assets-and-framework-routes",
          "route_pattern": "/_next/*, /assets/*, /images/*, /fonts/*, /locales/*, /storybook-static/*",
          "purpose": "Static assets and framework internals are not public page context route families.",
          "example_path": "/_next/static/example.js",
          "example_url": "https://nas.com/_next/static/example.js",
          "page_context_api": "not_available",
          "mcp_uri": "not_available",
          "guardrails": [
            "Do not use static assets or framework internals as product, community, or offer context.",
            "Use canonical public pages and documented AI-readable resources instead."
          ]
        }
      ]
    }
  ]
}