Skip to content

docs: prerender llms.txt and add contract coverage for AI discovery output#45110

Draft
pelikhan with Copilot wants to merge 2 commits into
mainfrom
copilot/geo-optimizer-add-llms-txt-again
Draft

docs: prerender llms.txt and add contract coverage for AI discovery output#45110
pelikhan with Copilot wants to merge 2 commits into
mainfrom
copilot/geo-optimizer-add-llms-txt-again

Conversation

Copilot AI commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

The docs site GEO audit flagged https://github.github.com/gh-aw/llms.txt as missing, which is a high-weight discovery signal for LLM crawlers. This change ensures llms.txt is emitted in static site output and guarded by a focused contract test.

  • Static publishing fix

    • Set prerender on docs/src/pages/llms.txt.ts so Astro always generates /gh-aw/llms.txt at build time (matching existing behavior already used by llms-full.txt).
  • Regression coverage

    • Added docs/tests/llms-txt.spec.ts to assert the published endpoint shape:
      • H1 title
      • description blockquote
      • section heading
      • at least one prompt link to .github/aw raw content
// docs/src/pages/llms.txt.ts
export const prerender = true;

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Add llms.txt to docs site docs: prerender llms.txt and add contract coverage for AI discovery output Jul 12, 2026
Copilot AI requested a review from pelikhan July 12, 2026 17:01
@github-actions

Copy link
Copy Markdown
Contributor

Hey @copilot-swe-agent 👋 — great work fixing the llms.txt prerender gap and adding contract coverage for the AI discovery endpoint! This PR is clean, focused, and well-described. It looks ready for review. 🚀

Generated by ✅ Contribution Check · 85.7 AIC · ⌖ 13.2 AIC · ⊞ 6.2K ·

@github-actions

Copy link
Copy Markdown
Contributor

🤖 PR Triage

Field Value
Category docs
Risk low
Priority Score 22/100
Score Breakdown impact: 10, urgency: 5, quality: 7
Action defer

Prerenders llms.txt and adds contract coverage. 2 files, +17/-0. Draft, CI unknown. Low-risk docs/test addition. Defer until draft is ready.

Generated by 🔧 PR Triage Agent · 142.9 AIC · ⌖ 7.2 AIC · ⊞ 5.6K ·

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[geo-optimizer] Add llms.txt to docs site (github.github.com/gh-aw/)

2 participants