[plan] GEO: Verify llms.txt generation and add llms-full.txt to docs site

[github-actions]

Objective

The GEO audit scored the docs site 0/18 for llms.txt despite the starlight-llms-txt plugin being configured. Verify the plugin is generating llms.txt correctly and add llms-full.txt for maximum score.

Context

From the GEO Audit Report in discussion #32848, the docs site (github.github.com/gh-aw/) scored 0/18 on llms.txt. The starlight-llms-txt plugin is imported and configured in docs/astro.config.mjs, but llms.txt is not present in docs/public/ (it's generated at build time). The audit confirms it's not accessible at https://github.github.com/gh-aw/llms.txt.

Possible causes:

1. The plugin generates llms.txt but the file is placed at the wrong path due to the base: "/gh-aw/" Astro config
2. The plugin is not generating the file at all (configuration issue)
3. A build or deployment issue is preventing the file from being deployed

Files to Examine

• docs/astro.config.mjs — starlightLlmsTxt plugin config
• docs/package.json — verify starlight-llms-txt version
• Check what path the plugin generates the file at in the build output

Approach

1. Run npm run build in the docs/ directory locally and check if llms.txt appears in the build output
2. If it's not generating, fix the plugin configuration
3. If it generates at the wrong path, fix the path issue
4. Add llms-full.txt — configure the plugin option to also generate a full version, or create a build script that generates it from the full site content
5. Verify the README llms.txt at github.com/github/gh-aw also has llms-full.txt (the audit noted it's missing)

Acceptance Criteria

• llms.txt is accessible at https://github.github.com/gh-aw/llms.txt
• llms-full.txt is accessible at https://github.github.com/gh-aw/llms-full.txt
• Both files contain accurate, comprehensive content about gh-aw
• Docs site llms.txt score improves from 0/18 toward 18/18

Generated by 📋 Plan Command · ● 7.3M · ◷

• expires on May 19, 2026, 4:55 PM UTC

[github-actions]

🍪 Issue Monster selected this for Copilot

I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

Om nom nom! 🍪

🍪 Om nom nom by Issue Monster · ● 77.4K · ◷