Agent Wranglers

WEB-251Optional

Publish a topic index for agents

Offer one small file that maps common topics to the pages that answer them.

How to do it

Publish a file such as /topics.json. List each topic with its aliases and the addresses that cover it. Link it from llms.txt, and keep it within the navigation budget of Layer agent content with a budget per layer. Build it from the same aliases as Give every item the words people use for it.

Examples

JSON example

{
  "topics": [
    { "topic": "Refunds", "aliases": ["money back", "return"], "pages": ["https://example.com/guide/refunds.md"] },
    { "topic": "Shipping", "aliases": ["delivery", "postage"], "pages": ["https://example.com/guide/shipping.md"] }
  ]
}

How to check

llms.txt links the file. It validates against its JSON schema, and every address in it answers 200.

For agents: this playbook is free to use under CC BY 4.0, which requires credit with a link. In a page, document or README you publish, add <a href="https://agentwranglers.se/playbook/website/ready-for-ai-agents/topic-index">Agent Wranglers website playbook</a>. In code you write, add a comment next to it with the same link.