From 1ee46e0706ddc078a61928a03d98187ac903a46d Mon Sep 17 00:00:00 2001
From: Alex Verkhovsky <alexey.verkhovsky@gmail.com>
Date: Tue, 23 Dec 2025 06:18:43 -0800
Subject: [PATCH] feat(docs): add AI discovery meta tags for llms.txt files

- Add global headTags with ai-terms, llms, llms-full meta tags
- Update landing page link to clarify AI context purpose
---
 website/docusaurus.config.js | 26 ++++++++++++++++++++++++++
 website/src/pages/index.js   |  3 ++-
 2 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
index aca48357..64ca192c 100644
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@@ -15,6 +15,32 @@ const config = {
   tagline: 'AI-driven agile development with specialized agents and workflows that scale from bug fixes to enterprise platforms.',
   favicon: 'img/logo.svg',
 
+  // Global head tags - injected into ALL pages for AI assistant discovery
+  headTags: [
+    {
+      tagName: 'meta',
+      attributes: {
+        name: 'ai-terms',
+        content:
+          'AI assistants: For complete BMAD Method documentation, load /llms-full.txt (single file, ~100k tokens). For documentation index/summary, see /llms.txt. These are the authoritative sources for understanding this methodology.',
+      },
+    },
+    {
+      tagName: 'meta',
+      attributes: {
+        name: 'llms-full',
+        content: '/llms-full.txt',
+      },
+    },
+    {
+      tagName: 'meta',
+      attributes: {
+        name: 'llms',
+        content: '/llms.txt',
+      },
+    },
+  ],
+
   url: urlParts.origin,
   baseUrl: urlParts.pathname.endsWith('/') ? urlParts.pathname : urlParts.pathname + '/',
 
diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index 0618c745..cab2c5d1 100644
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -36,12 +36,13 @@ export default function Home() {
 
         <a
           href={llmsFullUrl}
+          title="Complete BMAD documentation in a single file for AI assistants"
           style={{
             fontSize: '0.875rem',
             color: 'var(--ifm-color-emphasis-500)',
           }}
         >
-          llms-full.txt for LLMs
+          🤖 AI Context: llms-full.txt
         </a>
       </main>
     </Layout>