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


From 9e9435c238b560f43d3ef05b35223f6df0f6e81a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 1 Jul 2026 17:27:10 +0000
Subject: [PATCH 2/2] Add structured docs llms.txt endpoint content

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 docs/src/pages/llms.txt.ts | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/docs/src/pages/llms.txt.ts b/docs/src/pages/llms.txt.ts
index aa6408e4349..bdd68a1f867 100644
--- a/docs/src/pages/llms.txt.ts
+++ b/docs/src/pages/llms.txt.ts
@@ -1,17 +1,47 @@
 import type { APIRoute } from 'astro';
 import { getAwPrompts } from './_aw-prompts.js';
 
+export const prerender = true;
+
 export const GET: APIRoute = () => {
 	const prompts = getAwPrompts();
 
 	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.',
+		'> Official documentation and reference index for GitHub Agentic Workflows (gh-aw).',
+		'> Optimized for AI systems to discover key docs, examples, API/reference content, and project context.',
+		'',
+		'## Docs',
+		'',
+		'- [Documentation Home](https://github.github.com/gh-aw/)',
+		'- [Quick Start](https://github.github.com/gh-aw/setup/quick-start/)',
+		'- [Creating Workflows](https://github.github.com/gh-aw/setup/creating-workflows/)',
+		'- [Workflow Examples](https://github.github.com/gh-aw/examples/)',
+		'- [Workflow Patterns](https://github.github.com/gh-aw/patterns/)',
+		'',
+		'## Blog',
+		'',
+		'- [Blog Home](https://github.github.com/gh-aw/blog/)',
+		'- [What is GitHub Agentic Workflows?](https://github.github.com/gh-aw/blog/2026-01-13-meet-the-workflows/)',
+		'',
+		'## API / Reference',
+		'',
+		'- [CLI Reference](https://github.github.com/gh-aw/reference/cli/)',
+		'- [Workflow Syntax Reference](https://github.github.com/gh-aw/reference/workflow-syntax/)',
+		'- [Engine Reference](https://github.github.com/gh-aw/reference/engines/)',
+		'- [MCP Server Reference](https://github.github.com/gh-aw/reference/gh-aw-as-mcp-server/)',
+		'',
+		'## About',
+		'',
+		'- [About gh-aw](https://github.github.com/gh-aw/about/)',
+		'- [Contributing](https://github.com/github/gh-aw/blob/main/CONTRIBUTING.md)',
 		'',
 		'## Agent Prompts',
 		'',
+		'- [Agent Prompt Index](https://github.github.com/gh-aw/agents.txt)',
+		'- [Full Prompt Corpus](https://github.github.com/gh-aw/llms-full.txt)',
+		'',
 		...prompts.map(({ file, description, rawUrl }) => {
 			const label = file.replace(/\.md$/, '');
 			return description