- Keep code, query, result, and data examples in their dedicated source files. Render them in documentation through the corresponding MkDocs macro instead of embedding their contents directly in a page.
- Before starting a development server, check whether the project's documented development URL is responsive in the browser. Reuse it when available; start a server only when it is unavailable.
- docs/AGENTS.md - MkDocs authoring and ADR metadata conventions