Shoalrun documentation framework
For agents
Start with https://www.shoalrun.com/llms.txt for the documentation index, then read the Markdown pages it links. Skip to article. Documentation index. Read this page as Markdown.
Ingredient

Build the Shoalrun docs site

Compile authored documentation into local HTML, Markdown, and manifests.

Updated
Read as Markdown

Use the installed CLI to build Shoalrun's documentation:

npx --no-install shoalrun build docs/docs.config.yaml docs/dist

The source configuration is docs/docs.config.yaml; output goes to docs/dist. The root shortcut is npm run docs:build; it uses the installed package.

If the build fails, fix the named source or configuration issue and rerun it. A previous successful output can remain on disk after a failure, so file existence alone is not evidence of a successful new build.