Configure Astro Starlight with starlight-llms-txt extension

[Copilot]

This PR configures the starlight-llms-txt extension for the GitHub Agentic Workflows documentation site to automatically generate llms.txt files that provide structured documentation content for LLM training and context.

What this adds

The starlight-llms-txt extension automatically generates three types of llms.txt files from the existing Starlight documentation:

• /llms.txt (957 bytes) - Main index file with documentation structure and links
• /llms-small.txt (134K) - Abridged documentation optimized for efficient LLM context
• /llms-full.txt (140K) - Complete documentation for comprehensive LLM training

Changes made

1. Installed starlight-llms-txt package in the docs directory
2. Updated astro.config.mjs to:
   • Import and configure the starlight-llms-txt plugin
   • Add the required site URL (https://githubnext.github.io/gh-aw/)
   • Configure with project-specific description and helpful optional links

Configuration details

The extension is configured with:

• Custom description: Explains that gh-aw is a Go-based GitHub CLI extension for writing agentic workflows in markdown
• Optional links: Points to the GitHub repository and GitHub CLI documentation for additional context
• Automatic processing: All 16 documentation pages are processed during build

Benefits

• AI accessibility: Makes documentation easily consumable by LLMs and AI systems
• Multiple formats: Provides both compact and comprehensive versions for different use cases
• Build integration: Files are automatically generated and updated when documentation changes
• Standard compliance: Follows the llms.txt specification for structured AI training data

The generated files enable AI systems to better understand and work with GitHub Agentic Workflows by providing well-structured, comprehensive documentation in formats optimized for LLM consumption.


Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• telemetry.astro.build
  • Triggering command: node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)
  • Triggering command: node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro dev (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.