# docs-site

This project's developer docs. Authored in `src/*.md`, built with **mdBook**, published to
**GitHub Pages from this same repo**, and CI-gated against drift (see `docs/DOCS-STRATEGY.md`).

`theme/theme.css` is the **shared mdBook theme** — a Starlight-inspired skin reused verbatim
across consumer projects. Wire it via `additional-css = ["theme/theme.css"]` in `book.toml`;
re-point `--theme-accent` to rebrand.

## Reproducible generation

mdBook **0.5.3** is the pinned renderer. After editing `src/` or `SUMMARY.md`, regenerate the
checked-in agent export:

```bash
python ci/docs/build-docs.py --write
```

<!-- [doc->REQ-DOCS-PUBLISH-GATE] -->
Run the same drift and clean-build gate used by the Pages workflow:

```bash
sh ci/docs/check-docs.sh
```

The Pages build also publishes `llms.txt`, generated `llms-full.txt`, raw Markdown peers, the
adapter manifest/schema, and the release-evidence schema beside the rendered book.