The docs/ directory is now the shared source for three things:

  1. Human-readable project documentation.
  2. A Hugo site that can publish to GitHub Pages.
  3. LLM handoff material for future contributors and agents.

Start here

  • Project docs for architecture, frontend, Python, integration, and planning notes.
  • LLM handoff for concise project context and continuation guidance.
  • Published frontends for static builds copied from workspace apps during npm run docs:prepare.

Local docs workflow

npm run docs:prepare
npm run docs:dev
npm run docs:build

docs:prepare rebuilds frontend workspaces and copies any apps/*/dist/ output into the docs site under /apps/<workspace>/.

LLM handoff

High-signal context for future coding sessions.

Project docs

Core architecture, frontend, Python, integration, and planning notes.

Static frontends

Published frontend builds