From fc9c04b77576aa872e628e78156f03d197fd24d6 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 9 Jul 2026 17:18:25 +0000
Subject: [PATCH 1/2] Initial plan


From e57906041bb899612b6f651355ceda5aeedeadb9 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 9 Jul 2026 17:36:00 +0000
Subject: [PATCH 2/2] docs: improve llms.txt discoverability for GEO indexing

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 docs/README.md                       |  1 +
 docs/src/components/CustomHead.astro |  1 +
 docs/src/pages/llms.txt.ts           | 32 +++++++++++++++++-----------
 3 files changed, 22 insertions(+), 12 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index e8c464e14bd..e1058a87b30 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -49,6 +49,7 @@ If a CI pipeline or automated tool checks for the sitemap URL during a local pre
 This docs site is deployed as a GitHub Pages **project site** under `/gh-aw/` (see `base: '/gh-aw/'` in `astro.config.mjs`).
 
 - `robots.txt` is served at `/gh-aw/robots.txt`
+- `llms.txt` is served at `/gh-aw/llms.txt`
 - AI discovery file is served at `/gh-aw/.well-known/ai.txt`
 - AI metadata files are served under `/gh-aw/ai/`
 
diff --git a/docs/src/components/CustomHead.astro b/docs/src/components/CustomHead.astro
index f91400704ac..ff9ccbd5214 100644
--- a/docs/src/components/CustomHead.astro
+++ b/docs/src/components/CustomHead.astro
@@ -264,6 +264,7 @@ const filteredHead = head.filter(({ tag, attrs }) => {
 />
 
 <link rel="icon" type="image/svg+xml" href="/gh-aw/favicon.svg" />
+<link rel="alternate" type="text/plain" title="LLMs.txt" href="/gh-aw/llms.txt" />
 
 <!-- Responsive tables enhancement script -->
 <script>
diff --git a/docs/src/pages/llms.txt.ts b/docs/src/pages/llms.txt.ts
index aa6408e4349..9be917f5a78 100644
--- a/docs/src/pages/llms.txt.ts
+++ b/docs/src/pages/llms.txt.ts
@@ -1,23 +1,31 @@
 import type { APIRoute } from 'astro';
-import { getAwPrompts } from './_aw-prompts.js';
 
-export const GET: APIRoute = () => {
-	const prompts = getAwPrompts();
+export const prerender = true;
 
+export const GET: APIRoute = () => {
 	const lines = [
 		'# GitHub Agentic Workflows',
 		'',
-		'> Agent-optimised prompt files for GitHub Agentic Workflows (gh-aw).',
-		'> These markdown files are designed for AI agents and LLMs, not human readers.',
+		'> Documentation index for GitHub Agentic Workflows (gh-aw).',
+		'> Canonical docs: https://github.github.com/gh-aw/',
+		'',
+		'## Documentation',
+		'',
+		'- [Home](https://github.github.com/gh-aw/)',
+		'- [Quick Start](https://github.github.com/gh-aw/setup/quick-start/)',
+		'- [CLI Commands](https://github.github.com/gh-aw/setup/cli/)',
+		'- [Guides](https://github.github.com/gh-aw/guides/agentic-authoring/)',
+		'- [Reference](https://github.github.com/gh-aw/reference/)',
+		'- [Patterns](https://github.github.com/gh-aw/patterns/daily-ops/)',
+		'- [Examples](https://github.github.com/gh-aw/examples/maintaining-repos/)',
+		'- [Sitemap](https://github.github.com/gh-aw/sitemap-index.xml)',
 		'',
-		'## Agent Prompts',
+		'## AI Discovery',
 		'',
-		...prompts.map(({ file, description, rawUrl }) => {
-			const label = file.replace(/\.md$/, '');
-			return description
-				? `- [${label}](${rawUrl}): ${description}`
-				: `- [${label}](${rawUrl})`;
-		}),
+		'- [robots.txt](https://github.github.com/gh-aw/robots.txt)',
+		'- [ai.txt](https://github.github.com/gh-aw/.well-known/ai.txt)',
+		'- [agents.txt](https://github.github.com/gh-aw/agents.txt)',
+		'- [llms-full.txt](https://github.github.com/gh-aw/llms-full.txt)',
 	];
 
 	return new Response(lines.join('\n'), {