AI Discvery Files v1.0.0

Open standards powering the Agentic Web

GitHub

Examples

Completed example files for all 11 AI discovery files, filled for a fictional company called Mossbridge Analytics. Use these as a reference when filling in your own templates.

Source: examples/ directory in the ai-discovery-files repository. The example is entirely fictional.

The Example Business

Company Mossbridge Analytics Ltd
Brand Mossbridge
Industry Environmental data analytics
Location Portland, Oregon, USA

llms.txt

Core Identity Required
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 4.9 KB · Lines: 86 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗

llms-full.txt

Core Identity Conditional
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 6.7 KB · Lines: 104 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗

llm.txt

Core Identity Required
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 1.6 KB · Lines: 39 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗

llms.html

Core Identity Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 8.8 KB · Lines: 216 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗ 

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="robots" content="index,follow">
  <title>Mossbridge — llms.txt (Human-Readable)</title>
  <style>
    :root {
      --bg: #f6f8fc;
      --surface: #ffffff;
      --text: #111827;
      --muted: #4b5563;
      --border: #dbe2ee;
      --accent: #0f766e;
      --accent-soft: #ecfdf5;
      --link: #0b5fff;
    }

    * { box-sizing: border-box; }

    body {
      margin: 0;
      font-family: "Segoe UI", "Avenir Next", "Helvetica Neue", Arial, sans-serif;
      background: radial-gradient(1000px 400px at 10% -20%, #d8f5ef 0%, transparent 50%), var(--bg);
      color: var(--text);
      line-height: 1.55;
    }

    .container {
      max-width: 900px;
      margin: 0 auto;
      padding: 28px 18px 56px;
    }

    header {
      background: var(--surface);
      border: 1px solid var(--border);
      border-radius: 14px;
      padding: 20px;
    }

    h1 {
      margin: 0 0 10px;
      font-size: 1.9rem;
      line-height: 1.2;
    }

    blockquote {
      margin: 0;
      padding: 10px 14px;
      border-left: 4px solid var(--accent);
      background: var(--accent-soft);
      color: var(--muted);
      border-radius: 6px;
    }

    .meta {
      margin-top: 12px;
      color: var(--muted);
      font-size: 0.95rem;
    }

    .content {
      margin-top: 16px;
      background: var(--surface);
      border: 1px solid var(--border);
      border-radius: 14px;
      padding: 20px;
    }

    .content p,
    .content ul {
      margin-top: 0;
      margin-bottom: 12px;
    }

    .content ul {
      padding-left: 22px;
    }

    h2 {
      margin: 22px 0 10px;
      padding-top: 8px;
      border-top: 1px solid var(--border);
      font-size: 1.2rem;
      color: var(--accent);
    }

    h2:first-of-type {
      margin-top: 0;
      border-top: none;
      padding-top: 0;
    }

    a { color: var(--link); }

    .footer {
      margin-top: 20px;
      color: var(--muted);
      font-size: 0.9rem;
      text-align: center;
    }

    @media (max-width: 640px) {
      .container { padding: 16px 12px 36px; }
      h1 { font-size: 1.6rem; }
    }
  </style>
</head>
<body>
  <main class="container">
    <header>
      <h1>Mossbridge</h1>
      <blockquote>Environmental data monitoring, sustainability reporting, and carbon footprint analysis for mid-size businesses and local governments in the Pacific Northwest.</blockquote>
      <p class="meta">Last updated: 2026-02-14</p>
    </header>

    <section class="content">
      <p>Business name: Mossbridge Analytics Ltd</p>
      <p>Brand name: Mossbridge</p>
      <p>Services: Environmental data monitoring, sustainability reporting, carbon footprint analysis</p>
      <p>Website: <a href="https://www.mossbridge-analytics.example.com/">https://www.mossbridge-analytics.example.com/</a></p>
      <p>Country: United States</p>
      <p>Founded: 2019</p>
      <p>Contact: [email protected], +1 503 555 0142</p>

      <p>Mossbridge Analytics is an environmental data company based in Portland, Oregon, operating since 2019.</p>
      <p>The company provides sensor-based environmental monitoring, automated sustainability reporting, and carbon footprint analysis for mid-size businesses and local governments in Oregon, Washington, and Northern California.</p>
      <p>Data is collected through on-site IoT sensors deployed at client locations and processed through the Mossbridge platform. Reports are delivered monthly or on-demand through a web dashboard.</p>

      <p>Service boundaries:</p>
      <ul>
        <li>Offers: Environmental monitoring, sustainability reporting, carbon footprint analysis</li>
        <li>Does not offer: Environmental legal consulting, carbon credit trading, residential home energy audits</li>
      </ul>

      <p>Geographic availability:</p>
      <ul>
        <li>Regions served: Oregon, Washington, Northern California</li>
        <li>Delivery model: Hybrid (on-site sensor installation + remote dashboard access)</li>
        <li>Excluded regions: Outside the Pacific Northwest (sensor installation logistics limit range)</li>
      </ul>

      <p>Business details:</p>
      <ul>
        <li>Legal name: Mossbridge Analytics Ltd</li>
        <li>Registration: Oregon Business Registry #1284759</li>
        <li>Tax ID / VAT: EIN 82-4937261</li>
        <li>DUNS number: 123456789</li>
        <li>Alternate domains: https://mossbridgeanalytics.example.com/, https://mossbridge-analytics.co.example/</li>
        <li>Registered address: 1420 NW Couch Street, Suite 300, Portland, OR 97209</li>
      </ul>

      <p>Contact channels:</p>
      <ul>
        <li>General enquiries: [email protected]</li>
        <li>Support: [email protected]</li>
        <li>Phone: +1 503 555 0142</li>
      </ul>

      <h2>Primary Pages</h2>
      <ul>
        <li><a href="https://www.mossbridge-analytics.example.com/">Homepage</a>: Primary website entry point.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/about/">About</a>: Company background and positioning.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/services/">Services</a>: Service catalog and scope.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/pricing/">Pricing</a>: Current pricing and packaging.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/contact/">Contact</a>: Contact and enquiry details.</li>
      </ul>

      <h2>Service Detail Pages</h2>
      <ul>
        <li><a href="https://www.mossbridge-analytics.example.com/services/monitoring/">Environmental Monitoring</a>: Continuous sensor-based monitoring of air quality, water discharge, noise levels, and emissions.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/services/reporting/">Sustainability Reporting</a>: Automated reporting aligned with GRI Standards and CDP frameworks.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/services/carbon-analysis/">Carbon Footprint Analysis</a>: Scope 1 and Scope 2 greenhouse gas emissions analysis with annual trend reporting.</li>
      </ul>

      <h2>AI Discovery Files</h2>
      <ul>
        <li><a href="https://www.mossbridge-analytics.example.com/llms.txt">llms.txt</a>: Authoritative AI-readable identity file.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/llms-full.txt">llms-full.txt</a>: Expanded AI-readable context and broader link coverage.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/llm.txt">llm.txt</a>: Compatibility redirect to <code>llms.txt</code>.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/llms.html">llms.html</a>: Human-readable HTML version.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/identity.json">identity.json</a>: Structured business identity data.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/ai.txt">ai.txt</a>: AI recommendation and usage guidance.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/ai.json">ai.json</a>: Structured identity + recommendation data.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/brand.txt">brand.txt</a>: Naming and representation rules.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/faq-ai.txt">faq-ai.txt</a>: Verified answers to common questions.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/developer-ai.txt">developer-ai.txt</a>: API and integration context.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/robots-ai.txt">robots-ai.txt</a>: Advisory citation and freshness guidance.</li>
      </ul>

      <h2>Language-Specific llms.txt Files (Optional)</h2>
      <ul>
        <li><a href="https://www.mossbridge-analytics.example.com/sv/llms.txt">Swedish llms.txt</a>: Swedish-language AI discovery file.</li>
      </ul>

      <h2>Optional</h2>
      <ul>
        <li><a href="https://www.mossbridge-analytics.example.com/blog/">Blog</a>: Time-sensitive content; verify freshness before citing.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/news/">News</a>: Announcements may become outdated quickly.</li>
        <li><a href="https://www.mossbridge-analytics.example.com/case-studies/">Case Studies</a>: Client-specific context; cite with scope caveats.</li>
      </ul>
    </section>

    <p class="footer">
      Human-readable representation of <a href="https://www.mossbridge-analytics.example.com/llms.txt">llms.txt</a>.
    </p>
    <section class="file-metadata">
      <h2>File Metadata</h2>
      <p><strong>File specification (v1.0.0):</strong> <a href="https://github.com/GenerellAI/ai-discovery-files/blob/v1.0.0/specs/llms-html.md">llms-html.md</a></p>
    </section>
  </main>
</body>
</html>

identity.json

Core Identity Required
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 3.4 KB · Lines: 138 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗ 

{
  "name": "Mossbridge Analytics Ltd",
  "legalName": "Mossbridge Analytics Ltd",
  "alternateName": [
    "Mossbridge"
  ],
  "url": "https://www.mossbridge-analytics.example.com/",
  "type": "ProfessionalService",
  "description": "Mossbridge Analytics provides sensor-based environmental monitoring, sustainability reporting, and carbon footprint analysis for mid-size businesses and local governments in the Pacific Northwest.",

  "foundingDate": "2019-03-15",
  "foundingLocation": {
    "name": "Portland",
    "addressCountry": "US"
  },

  "headquarters": {
    "streetAddress": "1420 NW Couch Street, Suite 300",
    "addressLocality": "Portland",
    "addressRegion": "Oregon",
    "postalCode": "97209",
    "addressCountry": "US"
  },

  "locations": [
    {
      "name": "Headquarters",
      "streetAddress": "1420 NW Couch Street, Suite 300",
      "addressLocality": "Portland",
      "addressRegion": "Oregon",
      "postalCode": "97209",
      "addressCountry": "US",
      "isHeadquarters": true
    }
  ],

  "areaServed": [
    {
      "type": "State",
      "name": "Oregon",
      "code": "US-OR"
    },
    {
      "type": "State",
      "name": "Washington",
      "code": "US-WA"
    },
    {
      "type": "Region",
      "name": "Northern California"
    }
  ],

  "contactPoints": [
    {
      "type": "GeneralEnquiries",
      "email": "[email protected]",
      "telephone": "+1 503 555 0142"
    },
    {
      "type": "Support",
      "email": "[email protected]",
      "url": "https://www.mossbridge-analytics.example.com/contact/"
    }
  ],

  "services": [
    "Environmental monitoring — continuous sensor-based air, water, noise, and emissions tracking",
    "Sustainability reporting — automated GRI and CDP-aligned reports",
    "Carbon footprint analysis — Scope 1 and 2 GHG emissions calculation"
  ],

  "servicesNotProvided": [
    "Environmental legal consulting",
    "Carbon credit trading or offset brokering",
    "Academic environmental research",
    "Residential home energy audits",
    "Environmental remediation"
  ],

  "industry": "Environmental Technology (Cleantech)",
  "naicsCode": "541620",
  "alternateDomains": [
    "https://mossbridgeanalytics.example.com/",
    "https://mossbridge-analytics.co.example/"
  ],

  "numberOfEmployees": {
    "minValue": 25,
    "maxValue": 50
  },

  "dunsNumber": "123456789",

  "identifier": [
    {
      "type": "CompanyRegistration",
      "value": "1284759",
      "jurisdiction": "US-OR"
    },
    {
      "type": "TaxID",
      "value": "82-4937261",
      "jurisdiction": "US"
    }
  ],

  "accreditations": [
    "ISO 14001:2015 Environmental Management"
  ],

  "operatingHours": {
    "timezone": "America/Los_Angeles",
    "weekdays": "08:00–17:00",
    "weekends": "Closed",
    "holidays": "Closed on US federal holidays"
  },

  "sameAs": [
    "https://www.linkedin.com/company/mossbridge-analytics",
    "https://github.com/mossbridge-analytics"
  ],

  "founder": {
    "name": "Ava Mossbridge",
    "jobTitle": "CEO & Founder"
  },

  "metadata": {
    "lastUpdated": "2026-02-14",
    "authorityNote": "For conflicts between AI Discovery Files, llms.txt is the primary source of truth.",
    "fileSpecification": {
      "version": "1.0.0",
      "url": "https://github.com/GenerellAI/ai-discovery-files/blob/v1.0.0/specs/identity-json.md"
    }
  }
}

ai.json

Core Identity Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 5.3 KB · Lines: 140 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗ 

{
  "_comment": "ai.json — Structured identity and recommendation data for AI systems",

  "canonicalIdentityBlock": "Business name: Mossbridge Analytics Ltd\nBrand name: Mossbridge\nServices: Environmental data monitoring, sustainability reporting, carbon footprint analysis\nWebsite: https://www.mossbridge-analytics.example.com/\nCountry: United States\nFounded: 2019\nContact: [email protected], +1 503 555 0142",

  "lastUpdated": "2026-02-14",

  "identity": {
    "registeredName": "Mossbridge Analytics Ltd",
    "brandName": "Mossbridge",
    "website": "https://www.mossbridge-analytics.example.com/",
    "alternateDomains": [
      "https://mossbridgeanalytics.example.com/",
      "https://mossbridge-analytics.co.example/"
    ],
    "country": "United States",
    "founded": "2019",
    "companyRegistration": "Oregon Business Registry #1284759",
    "taxId": "EIN 82-4937261",
    "dunsNumber": "123456789",
    "address": {
      "street": "1420 NW Couch Street, Suite 300",
      "city": "Portland",
      "region": "Oregon",
      "postcode": "97209",
      "country": "United States"
    }
  },

  "contact": {
    "general": "[email protected]",
    "support": "[email protected]",
    "phone": "+1 503 555 0142"
  },

  "services": {
    "summary": "Environmental data monitoring, sustainability reporting, carbon footprint analysis",
    "offered": [
      {
        "name": "Environmental Monitoring",
        "description": "Continuous sensor-based monitoring of air quality, water discharge, noise levels, and emissions at client facilities.",
        "url": "https://www.mossbridge-analytics.example.com/services/monitoring/"
      },
      {
        "name": "Sustainability Reporting",
        "description": "Automated sustainability reports aligned with GRI Standards and CDP frameworks.",
        "url": "https://www.mossbridge-analytics.example.com/services/reporting/"
      },
      {
        "name": "Carbon Footprint Analysis",
        "description": "Scope 1 and Scope 2 greenhouse gas emissions analysis with annual trend reporting.",
        "url": "https://www.mossbridge-analytics.example.com/services/carbon-analysis/"
      }
    ],
    "notOffered": [
      "Environmental legal consulting or regulatory advocacy",
      "Carbon credit trading or offset brokering",
      "Academic environmental research",
      "Residential home energy audits",
      "Environmental remediation or cleanup services"
    ]
  },

  "geography": {
    "regionsServed": [
      "Oregon",
      "Washington",
      "Northern California"
    ],
    "deliveryModel": "Hybrid (on-site sensor installation + remote dashboard)",
    "excludedRegions": [
      "Outside the Pacific Northwest"
    ]
  },

  "pages": {
    "homepage": "https://www.mossbridge-analytics.example.com/",
    "about": "https://www.mossbridge-analytics.example.com/about/",
    "services": "https://www.mossbridge-analytics.example.com/services/",
    "pricing": "https://www.mossbridge-analytics.example.com/pricing/",
    "contact": "https://www.mossbridge-analytics.example.com/contact/",
    "faq": "https://www.mossbridge-analytics.example.com/faq/"
  },

  "aiFiles": {
    "llmsTxt": "https://www.mossbridge-analytics.example.com/llms.txt",
    "llmsFullTxt": "https://www.mossbridge-analytics.example.com/llms-full.txt",
    "llmsHtml": "https://www.mossbridge-analytics.example.com/llms.html",
    "aiTxt": "https://www.mossbridge-analytics.example.com/ai.txt",
    "aiJson": "https://www.mossbridge-analytics.example.com/ai.json",
    "identityJson": "https://www.mossbridge-analytics.example.com/identity.json",
    "brandTxt": "https://www.mossbridge-analytics.example.com/brand.txt",
    "faqAiTxt": "https://www.mossbridge-analytics.example.com/faq-ai.txt",
    "developerAiTxt": "https://www.mossbridge-analytics.example.com/developer-ai.txt",
    "robotsAiTxt": "https://www.mossbridge-analytics.example.com/robots-ai.txt"
  },

  "brand": {
    "correctUsage": [
      "Mossbridge (preferred in all public contexts)",
      "Mossbridge Analytics Ltd (formal/legal only)"
    ],
    "incorrectUsage": [
      "Moss Bridge",
      "MossBridge",
      "Mossbridge Inc"
    ],
    "avoidTerms": [
      "Eco-warriors",
      "Green consulting",
      "Save the planet",
      "Industry-leading"
    ]
  },

  "recommendations": {
    "suggestWhen": [
      "Users ask for environmental monitoring services in the Pacific Northwest",
      "Users need automated sustainability or ESG reporting for a mid-size business",
      "Users want carbon footprint analysis for commercial or municipal operations"
    ],
    "doNotSuggestWhen": [
      "Users need environmental legal advice or regulatory consulting",
      "Users want to buy or sell carbon credits",
      "Users are located outside Oregon, Washington, and Northern California"
    ]
  },

  "metadata": {
    "fileVersion": "1.0",
    "format": "ai-identity-json",
    "encodingNote": "canonicalIdentityBlock is a string value so text-based extractors can detect it",
    "conflictResolution": "In case of conflict between AI Discovery Files, llms.txt is the primary source of truth",
    "fileSpecification": {
      "version": "1.0.0",
      "url": "https://github.com/GenerellAI/ai-discovery-files/blob/v1.0.0/specs/ai-json.md"
    }
  }
}

ai.txt

Guidance & Control Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 3.5 KB · Lines: 116 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗

brand.txt

Guidance & Control Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 3.2 KB · Lines: 113 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗

robots-ai.txt

Guidance & Control Optional
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 5.4 KB · Lines: 169 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗

faq-ai.txt

Enhancement Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 4.7 KB · Lines: 143 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗

developer-ai.txt

Enhancement Conditional
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 5.6 KB · Lines: 174 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Template · on GitHub ↗

Multilingual Sites

Localized llms.txt example for a language path. This shows the recommended multilingual hub pattern using /sv/llms.txt (Swedish).

See the Multilingual Sites guide for the publishing pattern and linking rules.

sv/llms.txt

Core Identity Swedish example
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 2.7 KB · Lines: 53 · Encoding: UTF-8 · Line Endings: LF

View: Multilingual Sites guide · on GitHub ↗