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

Scaffold a new guide

Create a draft guide with a stable ID without overwriting an existing file.

Updated
Read as Markdown

Choose a file name, title, and stable document ID for your real topic. The commands use my-new-guide as the example; replace those values together.

npx --no-install shoalrun scaffold how-to -n docs/content/my-new-guide.mdx \
  --config docs/docs.config.yaml --id "$DOC_ID" --title 'My new guide'

The command refuses to overwrite an existing file. If this guide already exists, edit it directly instead of scaffolding it again. Keep its access policy set to draft while writing.