API reference guidance
Documentation for public modules is generated with mkdocstrings. To expose new
API pages:
- Add a Markdown file under
docs/reference/. - Place a directive such as
::: spicelab.analysisin the file. - Run
mkdocs buildto verify imports succeed (install the package in editable mode so mkdocstrings can import it).
Keep exports stable and prefer documenting the orchestrator and core component
APIs (spicelab.analysis, spicelab.core, spicelab.engines, spicelab.io).