feat(seo): improve AI-readiness

[navillanueva]

Makes build.avax.network easier for AI agents to read, and adds a CI guardrail so it can't quietly regress.

What changed

• Added a curated /llms.txt index — a hand-picked map of the content we want agents to find: all docs + blog, the Avalanche L1 and Entrepreneur academies, and the x402 course. It deliberately leaves out integrations and the rest of the Blockchain academy.
• Point agents to that index from every page and from each page's markdown.
• Serve every page as clean markdown (.md), and fix a bug where index pages didn't serve their .md version.
• Add a sitemap + robots; trim some page weight (decorative SVG → static asset).
• Add a CI check + tests so these pieces can't silently regress.

A caveat on the score

We can't realistically hit a literal 100% — our docs are too big for the checker's size limit. It's a trade-off: index everything and the file gets large enough that some AI tools cut it off mid-read, or curate the important pages (what we did) and the checker flags "incomplete coverage" because it expects the index to list every single page. We went with the curated index.

Known follow-up

A few pages where the markdown doesn't fully match the rendered page (interactive components) — content-side, separate effort.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
builder-hub	Ready	Preview, Comment	Jun 3, 2026 6:39pm