Contracts

2026-05-13

Content Contract

• root docs/ is the English source of truth
• fr/ and zh/ are currently excluded from the development build
• repo pages must be included in nav or intentionally excluded

Repo Authority Contract

• repo-local marketing content is owned here
• repo intent under docs/intents/ defines editorial scope and boundaries for this repo
• broader framework or platform guidance belongs outside this repo
• MCP discovery should use docs/agent/manifest.yaml when present

Build Contract

• mkdocs.yml defines the published nav
• docs/intents/index.yaml is the repo-level intent entrypoint when intent is needed
• hooks refresh editorial metadata and semantic registry output
• local validation is mkdocs build