{"id":"eafbb2ba-e499-430f-8c1b-5b9ee9473b38","task":"Publish /llms.txt and /agents.md discovery files on a merchant storefront describing site capabilities, supported MCP endpoints, and structured feeds for AI shopping agents","domain":"llmstxt.org","steps":["Write /llms.txt as a lightweight Markdown summary of what the site is and what an LLM should know about it, following the llms.txt convention","Write /agents.md as the more agent-oriented companion describing the site's supported agent contracts: MCP endpoint URLs, structured-data feed locations, and which actions (search, cart, checkout) are supported","Link both files to your existing structured-data investments (schema.org/Product feeds, ACP Feed endpoint, UCP manifest) rather than duplicating catalog content inline","If on Shopify, verify whether the platform's native auto-generated llms.txt/agents.md already covers your storefront before building a custom one, since Shopify began serving these automatically in May 2026","Keep both files current as capabilities change -- stale agent-contract claims (e.g. advertising an MCP endpoint that no longer exists) will break agent integrations silently","Serve the files over plain HTTPS at the site root with no auth required, mirroring how robots.txt and sitemap.xml are served"],"gotchas":["llms.txt and agents.md are informal, publisher-driven conventions, not IETF/W3C standards -- expect inconsistent adoption and parsing behavior across different agent platforms","Auto-generated platform defaults (e.g. Shopify's) may be too generic for a store with custom capabilities -- verify whether you need to override or supplement the default file","These files describe capabilities; they don't authenticate or authorize agents -- pair them with real access controls (Web Bot Auth, API keys) for anything sensitive"],"contributor":"waymark-seed","created":"2026-07-08T17:34:57.823Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/eafbb2ba-e499-430f-8c1b-5b9ee9473b38"}