content: add AI visibility / AEO guide (EN+ZH)#72
Merged
Conversation
New Layer 1 guide on making a site legible to AI answer engines: llms.txt + llms-full.txt, explicit AI bot signaling in robots.txt, JSON-LD differentiation by content type, and the external indexes AI engines actually read (Bing Webmaster AI Performance panel, Perplexity Publishers, llms.txt directories). Closes the AEO workstream started in #69 (baseline) and #70 (llms-full.txt). Each practice in the guide links to its primary source (llmstxt.org, schema.org, vendor bot docs); an "Inspiration" section acknowledges Tw93's May 2026 post as the synthesis that triggered this handbook's action.
Contributor
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes the AEO workstream started in #69 (baseline: robots.txt AI allow-list, JSON-LD differentiation, identity graph) and #70 (llms-full.txt). This is the Layer 1 content deliverable — a practitioner-facing guide on making any site legible to AI answer engines.
What the guide covers
Five signals and the canonical source for each:
TechArticle,HowTo,citation,@graph; linked to schema.org and Google's structured data docs.llms.txtdirectories, Perplexity Publishers.Plus an explicit What to Avoid section: spam-for-AI (generating low-effort content to game citations) is called out as the failure mode that this discipline is sometimes confused with.
Source traceability
Per the handbook's source-traceability rule, every specific practice links to its primary source. A final Inspiration section acknowledges Tw93's May 2026 post as the synthesis that triggered this handbook's own AEO baseline work, without making it a substitute for the canonical sources.
Layer positioning (SPEC 006)
Layer 1 Universal Content — no hardcoded references to this project in the main body. Where the handbook's own implementation illustrates a practice, it appears in clearly marked callout blocks (for example, the
build.mjsreference under the llms.txt section), not as the guide's main thread.Tested
SITE_URL=https://agent-master-handbook.vercel.app npm run build— 30 pages built (was 28, +2 for EN/ZH).TechArticleschema with author and publisher, matches other guides.llms.txtand included inllms-full.txt(which grew from 43KB to 56KB).ROADMAP
Item will be checked off when this PR merges, following the same convention as other published guides.