Skip to content

feat: add curated llms.txt with validation CI#1750

Closed
omarespejel wants to merge 8 commits into
starknet-io:mainfrom
omarespejel:codex/llms-txt-curated-apr2026
Closed

feat: add curated llms.txt with validation CI#1750
omarespejel wants to merge 8 commits into
starknet-io:mainfrom
omarespejel:codex/llms-txt-curated-apr2026

Conversation

@omarespejel

@omarespejel omarespejel commented Apr 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Add a production-ready, curated llms.txt for docs.starknet.io, and enforce it with a lightweight validation check.

Changes

  1. Add root llms.txt with high-signal canonical docs links and concise descriptions.
  2. Add scripts/validate_llms_txt.py to validate format, link shape, duplicates, and local path mapping.
  3. Add .github/workflows/llms-check.yml to run validation on PRs and on main updates touching llms assets.

Why

  • Curated llms.txt improves retrieval quality compared with broad auto-generated lists.
  • Mintlify supports custom llms.txt override while preserving llms-full.txt for exhaustive context.
  • Search-oriented AI crawlers use explicit bot controls and robots policy (OpenAI/Anthropic/Perplexity).

References:

Validation

  • python scripts/validate_llms_txt.py
  • Result: llms.txt validation passed: 45 links, 6 sections, no format/link errors.
  • Spot-check: all linked URLs currently return HTTP 200.

Scope

  • No robots.txt changes in this PR.
  • Focused only on llms.txt quality and guardrails.

@omarespejel omarespejel changed the title Curate llms.txt for high-signal AI discovery + add validation CI Curate llms.txt for production-grade AI discoverability Apr 9, 2026
@omarespejel omarespejel changed the title Curate llms.txt for production-grade AI discoverability feat: add curated llms.txt with validation CI Apr 9, 2026
@omarespejel omarespejel closed this Apr 9, 2026
@omarespejel omarespejel deleted the codex/llms-txt-curated-apr2026 branch April 9, 2026 12:43
@omarespejel omarespejel reopened this Apr 9, 2026
@omarespejel omarespejel marked this pull request as ready for review April 9, 2026 14:05
@omarespejel omarespejel closed this Apr 9, 2026
@omarespejel

Copy link
Copy Markdown
Contributor Author

Superseded by #1751, opened from the clean branch name .

@omarespejel

Copy link
Copy Markdown
Contributor Author

Superseded by #1751, opened from the clean branch name feat/llms-txt-validation.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant