kure256
Joined 2 years ago
Joined 2 years ago
The goal is to make content readable by anything. As more users access information through systems like ChatGPT instead of visiting websites directly, content that isn’t easily interpreted by AI crawlers risks becoming effectively invisible.
https://github.com/ai-first-guides/first.ai?tab=readme-ov-fi...
AI-first web design is based on a simple observation: more and more queries go directly to AI assistants instead of traditional search engines. If you want AI systems to understand, trust, and cite your content, the web must be written for them — not only for the visual browser. Just like SEO once made websites visible to Google, AI-first structure increases the chance that your website becomes the source AI systems quote.
I’m not arguing that “LLMs will replace browsing” in some absolute way — but it is observable that for many users, the entry point for information is shifting from search → assistant. When you actually inspect how models consume real websites today, the results are pretty uneven:
pages with clean HTML and predictable structure get parsed reliably
JSON-LD is used surprisingly often (but only if it’s correct and minimal)
heavy client-side rendering breaks extraction more than people expect
semantic markup still beats any “AI-enabled” tool by a mile
models hallucinate less when the source has clear hierarchy and meaning
This project isn’t trying to reinvent SEO — it’s more like exploring the minimum structural guarantees that make an LLM treat a page as a trustworthy, cite-able source instead of ignoring it or misreading it.
If anyone here has done experiments with:
how GPT, Claude, Gemini, Llama, etc. read arbitrary web pages
failure cases in parsing / hallucination caused by layout
the effect of metadata vs full-text signal
or even prompt strategies for web ingestion
…I’d genuinely love to compare notes.
If the web doesn’t adapt, a lot of high-quality content will slowly disappear from the “AI layer” of discovery.
We’re trying to document this shift here: https://github.com/ai-first-guides/first.ai/blob/main/docs/i...
It’s not a framework — just a minimal, evolving set of best practices aimed at making the web machine-readable again.
Repo (docs): https://github.com/ai-first-guides/first.ai/blob/main/docs/i...
Feedback, Contribution and Stars from HN is welcome.
Used in production for parallel Kubernetes cluster provisioning (CAPI + Fleet).