Docs indexing workflow:

1. Validate MDX frontmatter and internal slug links.
2. Build docs/data.json from MDX metadata.
3. Stage generated docs/data.json in pre-commit.

This workflow is enforced by the pre-commit docs-build hook.

Scripts live in utils/docs/:

• validate.py
• build_index.py
• utils.py
• hook.sh