Documentation Is Written in English
Every Markdown file in the repository is written in English. A repository has one working language, and documentation that drifts into another splits its readers: the next person to open the file may not be the one who wrote it.
This covers the root README.md, project documentation under docs/, guides, standards, and any instruction file an assistant reads.
Two things are not violations of it.
A file inside a locale folder is written in that locale's language. A path segment naming a language — es, en, pt — declares what the file holds, and a Spanish document under es/ is doing exactly its job. English remains the source.
handbook/onboarding.md English, the source
handbook/es/onboarding.md Spanish, translated from it
A document written for the client is written in the client's language. A feature analysis under an analysis/ folder is a deliverable someone outside the team reads and approves, so it follows that reader, not the repository. The same goes for any generated document handed to a user.
Everything else defaults to English, including a file that only the team will ever read. "Only I will read this" is how a repository ends up in two languages.
The validator checks each Markdown prose block independently. Outside the exceptions above, a block containing more than three distinct Spanish words is Spanish prose and is a violation, even when the rest of the document is English. Code fences and inline code are examples, not documentation prose, so they are excluded.
When a document has to change language, move it and translate it in separate changes. A diff that relocates and rewrites at once cannot be checked: a paragraph lost in the move looks exactly like a paragraph reworded in the translation.