About

buyer.md is an open convention for a small Markdown file that describes your shopping preferences to an AI agent. One file. Paste it anywhere. Skip the warmup.

It exists because every shopping conversation with an AI starts the same way: ten messages explaining yourself before the agent can be useful. A buyer.md file makes that context portable. Write it once, reuse it everywhere.

What it is

• A Markdown file with YAML frontmatter
• An open specification — anyone can read, write, or implement it
• Permissive by design — almost every field is optional
• Designed to be human-edited, not generated by a server

What it isn't

• Not a wallet — no card numbers, passwords, or credentials
• Not a contract with merchants — your agent decides what to share
• Not a hosted service — this site never stores your file
• Not a standard yet — it's a convention. If it catches on, maybe it becomes one

Who made it

Started by Wade Sonenberg, who also builds Bot It AI — the seller-side counterpart for agentic commerce on Shopify. buyer.md is the buyer-side piece of the same emerging stack.

License

MIT. Use it, fork it, build tools around it, ship products that read or write it. The whole point of a convention is that it spreads.

Contributing

The spec lives at github.com/OutdoorsBlogger/buyer.md. File an issue, send a PR, fork it, break it, improve it. v0.1 will change — that's the point.

Related conventions

• SOUL.md — agent personality
• taste.md — broader human taste, agent-observed
• AGENTS.md — agent behavior for codebases

buyer.md is the commerce-shaped piece of that family.