1.6 KiB
AGENTS.md — Documentation website adapter
Follow the root instructions, the documentation standard, and the documentation workflow.
Keep documentation content out of this tree
website/ owns only VitePress configuration, presentation assets, and the publication manifest. This file is the only maintained Markdown file in this subtree.
Keep canonical prose and generated catalogs in their owning docs/ tier, then expose selected pages through docs.ts. Never add locale, route, API, or copied documentation trees such as website/zh-CN/, website/en/, or website/api/.
The projector writes disposable Markdown to the ignored website/.generated/ directory. Never edit or commit .generated/, .cache/, or .dist/.
Production builds remove the configured output directory after VitePress resolves the site configuration and before it writes files. They reject output whose lexical path or nearest existing parent escapes the real site root, and unlink a link-shaped output instead of traversing its target. Raw-Markdown emission then treats files produced by that build as occupied and never overwrites them.
The build also emits each route's raw-Markdown twin (with a parent-level alias per index route) and a root llms.txt index into .dist/, so a page's URL, minus any trailing slash, plus .md serves it as plain Markdown. Both derive from the publication manifest at build time; neither is ever a file in this tree.
Run pnpm docs:check after changing this subtree; the gate rejects additional non-ignored Markdown under website/.