[WIP] Create /llms.txt for the documentation site

[Copilot]

Thanks for asking me to work on this. I will get started on it and keep this PR's description up to date as I form a plan and make progress.

---

This section details on the original issue you should resolve

<issue_title>[geo-optimizer] Create /llms.txt for the documentation site</issue_title>
<issue_description>### GEO Improvement: Create /llms.txt for the documentation site

Source audit: GEO Audit Report — 2026-08-18 (discussion published in this workflow run)
Audit date: 2026-08-18
Run: https://github.com/github/gh-aw/actions/runs/32160801176

Finding

llms_txt check: score 0/18, found: false. No /llms.txt file exists at https://github.github.com/gh-aw/llms.txt. Recommendation from the audit: "Create /llms.txt for AI indexing: geo llms --base-url https://github.github.com/gh-aw. Note: llms.txt is an organizational signal, not a proven ranking factor. It helps structure content for AI systems."

Why this matters

llms.txt is an emerging convention (championed by Anthropic, adopted by many docs sites) that gives AI engines a structured, curated map of a site's content — an H1, description, and categorized links to key pages. It is currently the single largest zero-scoring category on the docs-site audit (0/18, the maximum possible category weight), and the same gap also appears across all 20 sampled sitemap pages (average llms score: 0.0/18). Because gh-aw's docs already have strong meta tags, schema, and content structure, adding this one file is a low-effort, high-leverage way to close the largest scoring gap without any content rewrites.

Suggested fix

1. Run the geo-optimizer CLI to scaffold the file: geo llms --base-url https://github.github.com/gh-aw.
2. Ensure the generated /llms.txt includes:
   • An H1 with the project name ("GitHub Agentic Workflows").
   • A one-paragraph description (can reuse the existing meta description: "GitHub Agentic Workflows (gh-aw) lets developers define AI-powered repository automation in Markdown with YAML frontmatter and run AI agents through GitHub Actions using controlled permissions, sandboxing, and safe outputs.").
   • Sections grouping links by topic (e.g., Getting Started, Workflow Authoring, Safe Outputs, MCP Integration, CLI Reference).
   • A blockquote summary and an "Optional" section per the llms.txt spec, if applicable.
3. Publish the file at the docs site root so it resolves at https://github.github.com/gh-aw/llms.txt (this typically means adding it to the Astro/Starlight public/ directory so it's served unprocessed).
4. Re-run the GEO audit to confirm the llms_txt check now passes (target: 15+/18).

Generated by 🌍 GEO Optimizer Daily Audit · auto · 21.1 AIC · ⌖ 5.94 AIC · ⊞ 7.7K · ◷

• expires on Aug 25, 2026, 8:42 AM UTC-08:00

• Closes [geo-optimizer] Create /llms.txt for the documentation site #53759

Comments on the Issue (you are @copilot in this section)

• Fixes [geo-optimizer] Create /llms.txt for the documentation site #53759