agents.md and the Universal Commerce Protocol (UCP) — researched

agents.md and the Universal Commerce Protocol (UCP) are the two-layer agent-facing commerce discovery stack Shopify exposes on every storefront: agents.md is the canonical, merchant-authored Markdown signpost (distinct from the unrelated repo-root AGENTS.md coding-agent convention) that points at UCP, the Apache-2.0 machine-readable protocol Google launched with Shopify on 2026-01-11 for capability negotiation, RFC 9421-signed requests, and commerce transactions via /.well-known/ucp and its REST/MCP/A2A/Embedded transports. Summarized from 2 sources (the agents-md.md and ucp-protocol.md hub reference files, each a /dr research pass with live-fetch verification), covering definition, structure, mechanism, examples, measures, problems and facts facets across both the file-collision/rollout side and the protocol/governance/negotiation/signing side.

Definitions

Structure and components

How it works

How-to and procedures

Measurements and reference values

Problems, failure modes and limitations

Comparisons and alternatives

Facts and statements

Disagreements

Related concepts