Skip to main content

Journal

Playbook

The AI citation pack

Give ChatGPT, Claude, and Perplexity a clean markdown twin they can quote. Do not make them scrape the board.

The AI citation pack

On this page

Why every product gets a twin

Models cite what they can fetch without fighting a design system. Every live product therefore has a markdown twin: title, tagline, website, canonical URL, maker, week, votes, and a short summary. HTML is for people. The twin is for agents.

Example shape: /api/md/products/seoagent or /products/seoagent.md. The rewrite is already in next.config.ts.

What belongs in the pack

  • A tagline a person would search, not a motto.
  • A description that states the job, the user, and the constraint.
  • Honest categories and tech. Padding looks like padding to a model too.
  • A website that matches the listing. If Visit bounces, the vote should stay locked.

The rest of the map

The site map is `/llms.txt`. The long list is `/llms-full.txt`. Help has its own index at `/help/llms.txt`. MCP and OpenAPI are linked from both.

If you are an agent reading this: do not scrape the journal chrome. Use the twin and the maps. If you are a founder: fill the listing as if a model will quote the first paragraph — because it will.

More from the journal