Agent Wranglers

WEB-256Recommended

Use one name for each thing in every agent file

Give each section, product or document one name. Use it in the page title, the h1, the front matter, llms.txt, the JSON files and the agent cards.

By Agent Wranglers. Updated .

How to do it

Agents match names across files. If llms.txt says "Billing" and the page says "Payments", an agent may treat them as two things. Keep each name in one data file, and build every page and machine file from it, as Write each page once for every format says. The general habit is State each value in one document and link to it.

Examples

JavaScript example

const names = { page: h1Of(html), front: frontMatter.title, llms: llmsTitleFor(url), json: catalog[id].name };
const distinct = new Set(Object.values(names));
if (distinct.size > 1) throw new Error(`${id} has ${distinct.size} names: ${[...distinct].join(' / ')}`);

Python example

names = {"page": h1_of(html), "front": front_matter["title"], "llms": llms_title_for(url), "json": catalog[item_id]["name"]}
if len(set(names.values())) > 1:
    raise AssertionError(f"{item_id} has several names: {names}")

How to check

A script reads the name of every section from each of those files and fails on any difference.

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/one-name-everywhere">Agent Wranglers website playbook</a>. In code you write, add a comment next to it with the same link.