Skip to content

feat: serve the site in a form agents can read - #41

Merged
sepehr-safari merged 1 commit into
mainfrom
readable-by-agents
Sep 24, 2026
Merged

sepehr-safari merged 1 commit into
mainfrom
readable-by-agents

Conversation

@sepehr-safari

Copy link
Copy Markdown
Contributor

Closes #40

Every page gets a Markdown twin at its path with .md added, generated at build by scripts/agent-files.mjs from the same MDX (JSX turned into Markdown, code blocks left alone) and linked from the page with <link rel="alternate" type="text/markdown">. The generated files are gitignored, so they can never drift from the pages.

Also added: /llms.txt (hand-written index of projects, the two agent skills, and the docs), /llms-full.txt (every page in _meta order), /sitemap.xml and /robots.txt built from content/, schema.org JSON-LD per page, and the IndexNow key file. The site URL still comes from the environment only; the layout, sitemap, robots and JSON-LD now share it from app/site-url.js.

Checked locally with next start: all of /robots.txt, /sitemap.xml, /llms.txt, /llms-full.txt, /deed.md, /index.md and the key file return 200 with the right content types, and the built deed.html carries the alternate link and its JSON-LD.

Every page now has a Markdown twin at its path with .md added, generated at
build from the same MDX and linked from the page as a text/markdown
alternate. llms.txt indexes the projects and docs, llms-full.txt carries every
page in one file, and sitemap.xml and robots.txt are built from content/ so a
new page is listed the moment it exists.

Each page also carries schema.org JSON-LD saying what it describes: the
library as source code, Plaza, Notary and deed as applications, the home page
as the organization and the site. The IndexNow key file lets changed pages be
announced to search engines directly.
@vercel

vercel Bot commented Sep 24, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
zignostr.com Ready Ready Preview Sep 24, 2026 9:09am UTC

@sepehr-safari
sepehr-safari merged commit 69b1c0e into main Sep 24, 2026
3 checks passed
@sepehr-safari
sepehr-safari deleted the readable-by-agents branch September 24, 2026 09:09

This branch was successfully deployed

1 active deployment
Preview — b7a3ecd1 Deployed Sep 24, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Make the site readable by agents and answer engines

1 participant