Thoughts
Your website should have a page made for AI to read
Documentation sites are changing faster than marketing sites.
Vercel lets you append .md to a docs URL and get the Markdown version of the page. Attio publishes an AI guide with llms.txt, llms-full.txt, Markdown views, ChatGPT links, Claude links, and an MCP server. GitBook and Fern are baking the same idea into their platforms. The browser page still works for humans. There’s a second path now: a clean copy for whatever agent is doing the reading.
Most normal websites haven’t caught up.
Search isn’t the only reader
I already wrote about how AI discovery is changing service business websites. Someone asks ChatGPT who to call for dryer vent cleaning in the Triad. The model reads enough web content to make a recommendation. That kind of discovery is going to keep growing.
There’s a second pattern that matters just as much for a site like this one.
You’re in Cursor, Claude, ChatGPT, or some other agent tool. You find an article while researching a problem. Route-aware scheduling. Secret management for AI agents. A case study on how a service business CRM handles booking, quoting, territory rules, and follow-up.
You read it. Then you want your agent to read it too.
That’s where normal HTML gets noisy. Navigation, headers, footers, image markup, analytics scripts, CSS class names, card layouts, responsive wrappers. A browser needs some of that. An agent mostly doesn’t.
What the docs platforms figured out
Developer documentation moved first because the pain is obvious. If your coding assistant guesses against stale training data, you waste an afternoon. If it can fetch current docs in Markdown, it has a better shot.
The shape is pretty consistent across vendors:
/llms.txtgives agents a short map of the site./llms-full.txtdumps a larger single-file export when the docs are big enough to need one..mdpage variants give a clean source for one topic at a time.- “Copy as Markdown” buttons let a human drop the page into a prompt without hand-cleaning HTML.
- A few platforms are adding MCP servers for deeper, queryable access.
This isn’t an API-docs-only trick. It’s a signal about who the page is for. Not just the person looking at pixels. Also the assistant they brought with them.
What I added on servbin.io
servbin.io is informational on purpose. Dark, text-first, quiet. No animated hero trying to impress you before you know what the site is about. The work is the content: case studies, system choices, service business software, notes from running the stack.
That content is useful agent context.
The route-aware booking article helps when you’re designing scheduling software and want to steer an agent away from a naive calendar picker. The secret management article is the one I hand a coding tool before it reaches for a .env file. The VentBusting.com case study shows what a service business site built for AI discovery actually looks like.
So the long-form pages here now have an AI Markdown link. Thoughts expose /thoughts/{slug}.md. Case studies expose /case-studies/{slug}.md. HTML stays canonical for people. Markdown is the low-noise version for agents.
Paste that URL into an IDE chat, project rule, research prompt, or internal doc. The agent gets the article without the chrome.
Clearer writing helps both readers
Writing for AI ingestion doesn’t mean keyword stuffing or performing for a robot. It means being clearer than the average marketing page.
Say which system you’re talking about and what breaks when it goes wrong. Keep headings honest, put the actual point in the text instead of baking it into an image, and link related pages so an agent can follow the trail.
A lot of websites are going to struggle here. The flashy JavaScript site from the last decade was built to create a feeling fast: big motion, tiny copy, gradient cards, vague claims, hero images with the real explanation trapped in pixels. That can look expensive and still tell an agent almost nothing about what the business actually does.
The next version of good web content is quieter. Easier to read, cite, retrieve, and reuse. Still designed for humans. Just not hostile to the tools humans now use alongside the browser.
Articles as prompt material
A good post isn’t only something you read and remember. It can become prompt material: vocabulary, constraints, examples, and direction before you write a detailed instruction.
Instead of “Build me better scheduling software,” you can say: “Read this first: /thoughts/route-aware-scheduling.md. Now help me design an intake flow for a field service business.”
Better starting point. The agent has context from someone who’s actually dealt with the routing problem. It knows why a blank calendar isn’t enough. It has a framework before it starts generating UI.
Sites that ship clean Markdown versions give agents better source material to work from, and that shows up in the answers.
This site exposes a curated llms.txt file and Markdown versions of thoughts and case studies. HTML is for people. Markdown is for the agents people bring with them.
