Current guides live in docs/en/ and docs/es/ with matching relative paths.
English is the reference for resolving translation differences. Neither language
overrides verified implementation evidence or the binding architecture rules.
Update both versions together when behavior, commands or paths change.
Every current page links to its language index and counterpart. Run
npm run docs:check to check local links and the presence of matching pages.
This validates navigation and coverage, not semantic translation accuracy.
Historical documents stay in their original language under en/history/ or
es/history/. They record what was true or proposed at their date. The original
project brief includes both languages and remains intact in the Spanish archive.
History is not duplicated or treated as current setup instructions.
.agents/ remains the single English architecture contract. Provider indexes,
SVG originals and OpenAPI snapshots remain in llms/ and contracts/; their
external source formats are not translated.
The API reads docs/en/fidelity/<provider>.md, including the heading
## What is not emulated. These files and headings are part of the runtime
contract. A move must update fidelity.ts, its tests, the Docker COPY and
.dockerignore in the same change. The Spanish pages are reader-facing mirrors.