Docs feedback: is llms.txt structure useful for agent-readiness?

Documentation Feedback
1

I ran MARK’s docs profile against the Temporal docs site to test whether agent-readiness checks produce useful docs feedback for developer platforms.

MARK found /llms.txt and /llms-full.txt, which is good. The remaining findings I would like challenged are:

  • MARK scored the llms.txt structure as improvable for agent use.
  • MARK did not detect stable OpenAPI or MCP-style/agent metadata at the checked docs-surface paths.

This may be a MARK profile issue for workflow/platform docs rather than an actual Temporal docs issue.
MARK currently treats stable well-known/root metadata URLs and homepage/docs link hints as primary discovery, with /llms.txt links as useful backup discovery.

Local repro, no telemetry:

npx mark-agent-readiness-kit https://docs.temporal.io --profile docs

The useful answer is just: wrong, obvious, or worth fixing?

Package: mark-agent-readiness-kit on npm
Source: WillSuo-Github/mark-agent-readiness-kit on GitHub