docs: improve agentic discovery score

[brendanjryan]

Motivation

Improve agent-readability and discovery for the documentation site. The agentic-seo --output-dir dist/public score improves from 61/100 (C) before to 97/100 (A) after.

Summary

• Add public agent discovery artifacts, including AGENTS.md, agent-permissions.json, and a compact agent.html entry point
• Publish well-known API routes for the API catalog, agent skill, permissions, and agent instructions
• Expand mppx skill metadata with capabilities, inputs, constraints, and documentation links
• Section and trim llms.txt so the short index stays under the 5K-token target
• Add Copy for AI and Markdown affordances to key documentation pages
• Add explicit titles to blog and services pages for cleaner generated metadata

Key design considerations

• Keep the generated llms.txt rewrite in Vite so Vocs remains the source generator while the emitted artifact is optimized for agents
• Serve the rewritten llms.txt during local development when a build artifact exists, so local audits match production output
• Use static agent.html as a low-noise HTML bridge for scanners and agents without changing the Vocs runtime route model
• Preserve existing documentation structure and add only agent-facing discovery surfaces

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
mpp	Ready	Preview, Comment	Jul 9, 2026 2:53pm

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1e459da3ce

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Add advertised root files to allowedPaths

The new agent index and API catalog advertise /AGENTS.md and /agent-permissions.json as primary agent-readable discovery files, but this allowlist only permits /, /.well-known/*, API docs, markdown mirrors, and llms files. If an agent enforces allowedPaths after reading this policy, the advertised instructions and permission document fall outside the allowed read surface, which self-blocks the discovery flow this file is meant to enable.

Useful? React with 👍 / 👎.