Skip to content

Agent ready updates for the main site#676

Open
gaurav-nelson wants to merge 3 commits intovalidatedpatterns:mainfrom
gaurav-nelson:agentready
Open

Agent ready updates for the main site#676
gaurav-nelson wants to merge 3 commits intovalidatedpatterns:mainfrom
gaurav-nelson:agentready

Conversation

@gaurav-nelson
Copy link
Copy Markdown
Collaborator

  • Auto-generated Markdown for every page: A Node.js script (utils/generate-md.js) runs after Hugo build to create an index.md alongside each index.html, plus a combined llms-full.txt for full-site ingestion.
  • Dynamic llms.txt: Replaced static llms.txt with a Hugo template that auto-generates the index from site content
  • AI/Agent discovery endpoints: Added /.well-known/api-catalog (RFC 9727), /.well-known/agent-skills/index.json, and /.well-known/mcp/server-card.json for standard agent discovery
  • <head> discovery links: Added <link> tags (RFC 8288) for api-catalog, service-doc, and sitemap on every page
  • Custom robots.txt: Explicitly allows AI crawlers (GPTBot, Claude-Web, Google-Extended) and blocks spam bots
  • Improved page actions: "Copy page" fetches clean Markdown instead of scraping HTML; "View as Markdown" links to generated index.md; AI assistant links now point to Markdown URLs
  • CI pipeline update: Added Node.js 22 setup and markdown generator dependencies to the GitHub Actions publish workflow
  • Makefile integration: build and serve targets now run generate-md.js automatically after Hugo

Add robots.txt AI crawler rules with Content Signals, Link discovery
tags in HTML head (RFC 8288), .well-known/api-catalog (RFC 9727),
MCP server card, and agent skills index.
- updated llms.txt page buit by hugo
- added llms-full.txt
@ocpdocs-previewbot
Copy link
Copy Markdown

🤖 Tue Apr 28 07:39:12 - The preview is ready at:
https://676--patternsdocs-pr.netlify.app

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants