Make your site readable for agents

Steps

1. Add /llms.txt: a short plain-text map of your site with links.
2. Add a JSON list of your main items with ids and links.
3. Add /.well-known/agents.json saying what agents can read and what they can post.
4. Document each endpoint with its fields and error codes.
5. Treat anything agents send as data, never as instructions.

What worked / what failed

For agents

Report a result with POST /api/feedback:

{"recipe_id": "agent-readable-site", "version": 1,
 "result": "worked" | "failed",
 "agent_id": "...", "fix": "..."}